finance-foundation

Get one financial entity by type and id (slug). Returns the full structured record including external identifiers (LEI/ISIN/FIGI) for companies. Data is seed-0.7 · marketcap-1 · 2026-08-30 — approximate reference values from public sources, versioned, NOT real-time (live_data series refresh every 3 hours). License CC BY 4.0. Correct uses: entity resolution, classification, relationships, jurisdiction/venue context. For live quotes or legal text go to the primary sources each entity links.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "companies",
        "markets",
        "assets",
        "funds",
        "banks",
        "countries",
        "research"
      ]
    },
    "id": {
      "type": "string",
      "description": "Entity slug, e.g. 'apple', 'nasdaq', 'bitcoin', 'united-states'"
    }
  },
  "required": [
    "entity_type",
    "id"
  ]
}

List entities of one type, optionally filtered. Companies filter by sector/country/q; assets by type (Crypto|Index|Bond|Currency|Commodity). Returns up to `limit` records (default 25).

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "companies",
        "markets",
        "assets",
        "funds",
        "banks",
        "countries",
        "research"
      ]
    },
    "q": {
      "type": "string",
      "description": "Substring filter across all fields"
    },
    "sector": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 25
    }
  },
  "required": [
    "entity_type"
  ]
}

Free-text search across all entity types (companies, markets, assets, funds, banks, countries, research). Returns grouped matches with links.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

Resolve a ticker, LEI, ISIN, FIGI, MIC code or name to entities. The entity-resolution tool: 'US0378331005' → Apple with all identifiers. Matches are ranked (exact identifier > ticker > name).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "e.g. 'AAPL', 'HWUPKR0MPOU8FGXBT394', 'US0378331005', 'BBG001S5N8V8', 'XNAS'"
    }
  },
  "required": [
    "query"
  ]
}

Knowledge-graph neighborhood of an entity: nodes and typed edges (lists_on, domiciled_in, managed_by, sector_peer…). Use to traverse from a company to its exchange, jurisdiction, funds and peers.

{
  "type": "object",
  "properties": {
    "entity_type": {
      "type": "string",
      "enum": [
        "companies",
        "markets",
        "assets",
        "funds",
        "banks",
        "countries"
      ]
    },
    "id": {
      "type": "string"
    }
  },
  "required": [
    "entity_type",
    "id"
  ]
}

Extract financial entities and relationships from unstructured text into Finance Foundation Schema v0.1 JSON (companies, markets, assets, funds, banks, countries, indicators + typed relationships + unresolved_identifiers). LLM-powered, validated (taxonomy, ISIN checksums, LEI/MIC formats). Read-only transform: output goes to the caller only and is NEVER added to the Finance Foundation dataset. Limit 6000 chars.

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "Unstructured financial text (article, filing excerpt, notes), ≤6000 chars"
    }
  },
  "required": [
    "text"
  ]
}

Latest reference values (refreshed every 3 hours): crypto (BTC/ETH/SOL/XRP/BNB/ADA/USDT/USDC/DAI), FX (EUR/USD, USD/JPY, GBP/USD, USD/CNY, USD/CHF, AUD/USD, USD/CAD, USD/INR, USD/BRL), ECB main refinancing rate, US 10Y Treasury yield, US CPI YoY. Each carries its source and observation date — NOT real-time ticks.

{
  "type": "object",
  "properties": {}
}