{"openapi":"3.1.0","info":{"title":"Shamburg Data API","description":"Financial statements, ratios, economic indicators, sovereign yields, insider\ntransactions, congressional trades, fund and institutional holdings, pension\nplans, investment advisers, dividends, splits, FINRA short data, FX reference\nrates, and market news — one key, one vocabulary, eleven data domains.\n\n**Base URL** `https://api.shamburgmarkets.com` · All endpoints are `GET` and\nreturn JSON.\n\n## Authentication\n\nSend your API key with every `/v1` request — either header works:\n\n```bash\ncurl -H \"Authorization: Bearer sm_live_...\" \\\n  \"https://api.shamburgmarkets.com/v1/search?q=apple\"\n# or: -H \"X-API-Key: sm_live_...\"\n```\n\nKeys are managed in the [developer portal](https://developers.shamburgmarkets.com).\nYour subscription tier sets a per-minute rate limit and a monthly request\nquota; every response reports where you stand via `X-RateLimit-Limit`,\n`X-RateLimit-Remaining`, `X-RateLimit-Reset`, and `X-Quota-Limit` /\n`X-Quota-Remaining` when a monthly quota applies.\n\n| Status | Code | Meaning |\n|---|---|---|\n| 401 | `MISSING_API_KEY` / `INVALID_API_KEY` / `KEY_REVOKED` / `KEY_EXPIRED` | Fix the key |\n| 402 | `PAYMENT_REQUIRED` | Subscription past due |\n| 403 | `SUBSCRIPTION_REQUIRED` | Plan has no API access |\n| 403 | `QUOTA_EXCEEDED` | Monthly quota exhausted (reset date in `error.details`) |\n| 429 | `RATE_LIMITED` | Slow down — honor `Retry-After` |\n\n**Congressional trading endpoints (`/v1/congress/*`) are free.** Under\n5 U.S.C. §13107(c) this data is disseminated to the general public at no\ncharge: any valid key reaches them, no subscription required.\n\n## Response envelope\n\nEvery success is `{\"data\": ..., \"meta\": {...}}`; every error is\n`{\"error\": {\"code\": \"...\", \"message\": \"...\", \"details\": {...}}}` with stable\nmachine-readable codes. Dates are ISO-8601. Monetary values are numbers with\nexplicit currency fields. Fields are present-but-null rather than omitted, so\nshapes are stable for typed clients.\n\n## Identifiers\n\nSecurity- and entity-scoped endpoints take one `{identifier}` path segment and\nauto-detect what you sent: **ticker, ISIN, CIK, LEI, FIGI, or a Shamburg\n`security_uuid`/`entity_uuid`**. The resolution is echoed back in\n`meta.identifier.resolved`. Numeric tickers (e.g. Japanese `6758`) auto-detect\nas CIKs — pass `identifier_type=ticker` (optionally with `country_code=JP`)\nto disambiguate. `entity_uuid` is the stable public join key across all\ndomains.\n\n## Pagination\n\nFeed-shaped endpoints use **cursors**: pass back `meta.pagination.next_cursor`\nas `?cursor=` until it is `null` (cursors are opaque — don't parse them).\nSmaller collections use `?limit=&offset=`. `limit` above the plan maximum is\nclamped server-side, never rejected.\n\nDelta-sync pattern for filing-driven feeds:\n\n```\nGET /v1/insiders/transactions?filed_since=2026-07-01&limit=100\nGET ...&cursor=<next_cursor>     # until next_cursor is null\n# next sync: filed_since = the last filing_date you saw\n```\n\n## Bulk data (flat files)\n\nPlans with the flat-files entitlement can skip pagination: gzipped CSV\nexports with the same field vocabulary as the API, listed and downloaded via\n`GET /v1/files` (downloads 302-redirect to short-lived signed URLs). Layout\nper domain: `daily/YYYY/MM/DD.csv.gz` incrementals,\n`snapshots/...-full.csv.gz` weekly fulls, `periods/...` per-quarter 13F and\nN-PORT files, plus a `manifest.json` with row counts and generation times.\n\nFINRA-sourced datasets (short interest, short volume) are excluded from bulk\nfiles by FINRA's terms; the per-security endpoints support `?format=csv`\ninstead, and FINRA data may not be redistributed.\n\n## Discovery\n\nMachine-readable legends for every enum and code the API uses:\n`/v1/catalog/vocabularies` (all enums), `/v1/catalog/countries`,\n`/v1/catalog/currencies`, plus per-domain catalogs (financial metrics,\nratios, rate series, filing forms, transaction codes, ...). Examples in this\nreference are real captured responses, truncated to two rows.","version":"1.0.0","contact":{"name":"Shamburg Markets","url":"https://developers.shamburgmarkets.com"}},"paths":{"/v1/search":{"get":{"tags":["reference"],"summary":"Search securities by symbol or name","operationId":"search_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Symbol prefix or name fragment","title":"Q"},"description":"Symbol prefix or name fragment"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"asset_class":"equity","currency":"USD","delisted_at":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","listing_country_code":"US","market_cap":4981218114110,"name":"Apple Inc.","primary_exchange":"NASDAQ","primary_mic":"XNAS","sector":"Technology","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"},{"asset_class":"equity","currency":"USD","delisted_at":null,"entity_uuid":"cade045e-28f2-4321-ba4c-b87e8466d786","listing_country_code":"US","market_cap":3831622189,"name":"Apple Hospitality REIT, Inc.","primary_exchange":"NYSE","primary_mic":"XNYS","sector":"Real Estate","security_type":"reit","security_uuid":"45d62b34-91b7-495f-9852-18eaa2677822","symbol":"APLE"}],"meta":{"count":2,"query":"apple"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/securities/{identifier}":{"get":{"tags":["reference"],"summary":"Security profile","operationId":"get_security_v1_securities__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"How to interpret the identifier (ticker, isin, cik, lei, figi, security_uuid). Auto-detected when omitted.","title":"Identifier Type"},"description":"How to interpret the identifier (ticker, isin, cik, lei, figi, security_uuid). Auto-detected when omitted."},{"name":"mic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":4,"maxLength":4},{"type":"null"}],"description":"Disambiguate tickers listed on multiple venues (operating MIC).","title":"Mic"},"description":"Disambiguate tickers listed on multiple venues (operating MIC)."},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"listings":[{"currency":"USD","is_active":true,"is_primary_exchange":true,"mic":"XNAS","operating_mic":"XNAS","symbol":"AAPL","venue_type":"exchange"},{"currency":"USD","is_active":true,"is_primary_exchange":false,"mic":"AQEA","operating_mic":"AQEU","symbol":"4AAPL","venue_type":"exchange"}],"profile":{"address_city":"CUPERTINO","address_country":"CA","address_postal":"95014","address_state":"CA","address_street":"ONE APPLE PARK WAY","asset_class":"equity","company_description":"Apple revolutionized personal technology with the introduction of the Macintosh in 1984. Today, Apple leads the world in innovation with iPhone, iPad, Mac, AirPods, Apple Watch, and Apple Vision Pro. Apple's six software platforms - iOS, iPadOS, macOS, watchOS, visionOS, and tvOS…","currency":"USD","delisted_at":null,"email":null,"employees":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","fiscal_year_end":"09-26","industry":"Technology Hardware & Equipment","instrument_type":"shares","isin":null,"issuer_country_code":"US","listing_country_code":"US","market_cap":4981218114110,"name":"Apple Inc.","phone":"(408) 996-1010","primary_exchange":"NASDAQ","primary_mic":"XNAS","region":"americas","sector":"Technology","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares_outstanding":14608963000,"symbol":"AAPL","website":"https://www.apple.com"}},"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/securities/{identifier}/identifiers":{"get":{"tags":["reference"],"summary":"Identifier crosswalk","description":"Full public-identifier crosswalk from api_serving.identifiers.\nCUSIP and SEDOL are licensed identifiers: accepted as lookup INPUTS via\nthe resolver but never served in responses (2026-09-13).","operationId":"get_identifiers_v1_securities__identifier__identifiers_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"How to interpret the identifier (ticker, isin, cik, lei, figi, security_uuid). Auto-detected when omitted.","title":"Identifier Type"},"description":"How to interpret the identifier (ticker, isin, cik, lei, figi, security_uuid). Auto-detected when omitted."},{"name":"mic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":4,"maxLength":4},{"type":"null"}],"description":"Disambiguate tickers listed on multiple venues (operating MIC).","title":"Mic"},"description":"Disambiguate tickers listed on multiple venues (operating MIC)."},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"cd_cvm":null,"cfi":"ESVUFR","cnpj":null,"composite_figi":"BBG000B9XRY4","dart_corp_code":null,"edgar_cik":"0000320193","edinet_code":null,"ein":"942404110","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","fund_class_id":null,"fund_series_id":null,"indian_scrip_code":null,"isin":null,"japanese_securities_code":null,"korean_stock_code":null,"lei":"HWUPKR0MPOU8FGXBT394","mops_security_code":null,"primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","share_class_figi":"BBG001S5N8V8","sic":"3571","symbol":"AAPL","uk_company_number":null},"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/exchanges":{"get":{"tags":["reference"],"summary":"Exchange / venue crosswalk","description":"Segment MIC -> operating MIC -> acronym/name. Bridges any listing's\nmic to venue-level datasets like /v1/calendar/market-holidays (keyed by\noperating MIC). Covers exactly the venues present in listings.","operationId":"exchanges_v1_exchanges_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"operating_mic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":4,"maxLength":4},{"type":"null"}],"description":"Roll-up venue, e.g. XNYS covers XNYS+ARCX+XASE","title":"Operating Mic"},"description":"Roll-up venue, e.g. XNYS covers XNYS+ARCX+XASE"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"city":"VIENNA","country_code":"AT","country_name":"Austria","exchange":null,"exchange_name":"WIENER BOERSE OFFICIAL MARKET","mic":"WBAH","operating_mic":"XWBO","timezone":"Europe/Vienna","venue_type":"EXCHANGE"},{"city":"VIENNA","country_code":"AT","country_name":"Austria","exchange":null,"exchange_name":"WIENER BOERSE VIENNA MTF","mic":"WBDM","operating_mic":"XWBO","timezone":"Europe/Vienna","venue_type":"MTF"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/search":{"get":{"tags":["entities"],"summary":"Search entities by symbol, name, or LEI","operationId":"search_entities_v1_entities_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80,"description":"Symbol prefix, name fragment, or exact LEI","title":"Q"},"description":"Symbol prefix, name fragment, or exact LEI"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"filing_system","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"EDGAR, EDINET, ESEF, COMPANIES_HOUSE, BSE, DART, CVM, MOPS","title":"Filing System"},"description":"EDGAR, EDINET, ESEF, COMPANIES_HOUSE, BSE, DART, CVM, MOPS"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"adviser_crd":null,"cd_cvm":null,"cnpj":null,"country_code":"JP","dart_corp_code":null,"edgar_cik":null,"edinet_code":"E02963","entity_type":"OPERATING_COMPANY","entity_uuid":"7bef906b-0433-46b5-8792-13e95d601583","filing_system":"EDINET","indian_scrip_code":null,"lei":"353800K9EVFX18OTAX03","mops_security_code":null,"name":"APPLE INTERNATIONALCO.,LTD.","parent_entity_uuid":null,"parent_hierarchy_type":null,"symbol":"2788","ultimate_parent_entity_uuid":"7bef906b-0433-46b5-8792-13e95d601583","ultimate_parent_name":"APPLE INTERNATIONALCO.,LTD."},{"adviser_crd":null,"cd_cvm":null,"cnpj":null,"country_code":"US","dart_corp_code":null,"edgar_cik":"0001418121","edinet_code":null,"entity_type":"OPERATING_COMPANY","entity_uuid":"cade045e-28f2-4321-ba4c-b87e8466d786","filing_system":"EDGAR","indian_scrip_code":null,"lei":"549300EVZAR0FBZO4F16","mops_security_code":null,"name":"Apple Hospitality REIT, Inc.","parent_entity_uuid":null,"parent_hierarchy_type":null,"symbol":"APLE","ultimate_parent_entity_uuid":"cade045e-28f2-4321-ba4c-b87e8466d786","ultimate_parent_name":"Apple Hospitality REIT, Inc."}],"meta":{"count":2,"query":"apple"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/{identifier}/subsidiaries":{"get":{"tags":["entities"],"summary":"Entities whose immediate parent is this entity","operationId":"get_entity_subsidiaries_v1_entities__identifier__subsidiaries_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets).","title":"Identifier Type"},"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"count":0,"parent_entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/{identifier}/complex":{"get":{"tags":["entities"],"summary":"Every entity in this entity's complex (shared ultimate parent)","operationId":"get_entity_complex_v1_entities__identifier__complex_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets).","title":"Identifier Type"},"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"adviser_crd":null,"cd_cvm":null,"cnpj":null,"country_code":"US","dart_corp_code":null,"edgar_cik":"0000320193","edinet_code":null,"entity_type":"OPERATING_COMPANY","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_system":"EDGAR","indian_scrip_code":null,"lei":"HWUPKR0MPOU8FGXBT394","mops_security_code":null,"name":"Apple Inc.","parent_entity_uuid":null,"parent_hierarchy_type":null,"symbol":"AAPL","ultimate_parent_entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","ultimate_parent_name":"Apple Inc."}],"meta":{"count":1,"ultimate_parent_entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","ultimate_parent_name":"Apple Inc."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/{identifier}":{"get":{"tags":["entities"],"summary":"Entity profile + its securities","operationId":"get_entity_v1_entities__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets).","title":"Identifier Type"},"description":"How to interpret the identifier (entity_uuid, lei, symbol, edgar_cik, edinet_code, dart_corp_code, mops_security_code, cd_cvm, cnpj, indian_scrip_code). Auto-detected when omitted; required when a bare code matches several id namespaces (e.g. numeric codes shared across markets)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"entity":{"adviser_crd":null,"cd_cvm":null,"cnpj":null,"country_code":"US","dart_corp_code":null,"edgar_cik":"0000320193","edinet_code":null,"entity_type":"OPERATING_COMPANY","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_system":"EDGAR","indian_scrip_code":null,"lei":"HWUPKR0MPOU8FGXBT394","mops_security_code":null,"name":"Apple Inc.","parent_entity_uuid":null,"parent_hierarchy_type":null,"symbol":"AAPL","ultimate_parent_entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","ultimate_parent_name":"Apple Inc."},"securities":[{"asset_class":"equity","currency":"USD","delisted_at":null,"instrument_type":"shares","isin":null,"listing_country_code":"US","market_cap":4981218114110,"name":"Apple Inc.","primary_exchange":"NASDAQ","primary_mic":"XNAS","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}]},"meta":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/insider":{"get":{"tags":["filings"],"summary":"Firehose: insider (Section 16) filings by filing date","operationId":"insider_firehose_v1_filings_insider_get","parameters":[{"name":"filed_since","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Filings on or after this date (your last sync point)","title":"Filed Since"},"description":"Filings on or after this date (your last sync point)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source-native form code (e.g. 4, 4/A)","title":"Form Code"},"description":"Source-native form code (e.g. 4, 4/A)"},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"owner_cik","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to one reporting owner's filings","title":"Owner Cik"},"description":"Filter to one reporting owner's filings"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/insider/id/{filing_uuid}":{"get":{"tags":["filings"],"summary":"A single insider filing by its filing_uuid","operationId":"insider_by_uuid_v1_filings_insider_id__filing_uuid__get","parameters":[{"name":"filing_uuid","in":"path","required":true,"schema":{"type":"string","title":"Filing Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/insider/{identifier}":{"get":{"tags":["filings"],"summary":"Insider filing history for an issuer","operationId":"insider_history_v1_filings_insider__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Code"}},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"owner_cik","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter to one reporting owner's filings","title":"Owner Cik"},"description":"Filter to one reporting owner's filings"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/institutional":{"get":{"tags":["filings"],"summary":"Firehose: institutional (13F) filings by filing date","operationId":"institutional_firehose_v1_filings_institutional_get","parameters":[{"name":"filed_since","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Filings on or after this date (your last sync point)","title":"Filed Since"},"description":"Filings on or after this date (your last sync point)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source-native form code (e.g. 13F-HR, 13F-HR/A)","title":"Form Code"},"description":"Source-native form code (e.g. 13F-HR, 13F-HR/A)"},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Exact report quarter-end (e.g. 2026-06-30)","title":"Period End"},"description":"Exact report quarter-end (e.g. 2026-06-30)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/institutional/id/{filing_uuid}":{"get":{"tags":["filings"],"summary":"A single 13F filing by its filing_uuid","operationId":"institutional_by_uuid_v1_filings_institutional_id__filing_uuid__get","parameters":[{"name":"filing_uuid","in":"path","required":true,"schema":{"type":"string","title":"Filing Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/institutional/{identifier}":{"get":{"tags":["filings"],"summary":"13F filing history for a manager","operationId":"institutional_history_v1_filings_institutional__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Code"}},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Exact report quarter-end (e.g. 2026-06-30)","title":"Period End"},"description":"Exact report quarter-end (e.g. 2026-06-30)"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/funds":{"get":{"tags":["filings"],"summary":"Firehose: fund portfolio (NPORT) filings by filing date","operationId":"fund_firehose_v1_filings_funds_get","parameters":[{"name":"filed_since","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Filings on or after this date (your last sync point)","title":"Filed Since"},"description":"Filings on or after this date (your last sync point)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source-native form code (e.g. NPORT-P)","title":"Form Code"},"description":"Source-native form code (e.g. NPORT-P)"},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"is_final_filing","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Only a series' final filing for its fiscal period","title":"Is Final Filing"},"description":"Only a series' final filing for its fiscal period"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/funds/id/{filing_uuid}":{"get":{"tags":["filings"],"summary":"A single NPORT filing by its filing_uuid","operationId":"fund_by_uuid_v1_filings_funds_id__filing_uuid__get","parameters":[{"name":"filing_uuid","in":"path","required":true,"schema":{"type":"string","title":"Filing Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/funds/{identifier}":{"get":{"tags":["filings"],"summary":"NPORT filing history for a fund","operationId":"fund_history_v1_filings_funds__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","description":"fund_uuid, series_id (S#########), class_id (C#########), or share-class ticker","title":"Identifier"},"description":"fund_uuid, series_id (S#########), class_id (C#########), or share-class ticker"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form Code"}},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"is_final_filing","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Final Filing"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings":{"get":{"tags":["filings"],"summary":"Firehose: all corporate filings by filing date","operationId":"firehose_v1_filings_get","parameters":[{"name":"filed_since","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Filings on or after this date (your last sync point)","title":"Filed Since"},"description":"Filings on or after this date (your last sync point)"},{"name":"source_system","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated: EDGAR, ESEF, DART, EDINET, CVM, BSE, MOPS","title":"Source System"},"description":"Comma-separated: EDGAR, ESEF, DART, EDINET, CVM, BSE, MOPS"},{"name":"form_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated standardized types (full list: /v1/catalog/filing-forms)","title":"Form Type"},"description":"Comma-separated standardized types (full list: /v1/catalog/filing-forms)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source-native form code (e.g. 10-K, 11011, DFP)","title":"Form Code"},"description":"Source-native form code (e.g. 10-K, 11011, DFP)"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"has_financials","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Only filings with parsed financial statements (/v1/financials)","title":"Has Financials"},"description":"Only filings with parsed financial statements (/v1/financials)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accounting_standard":null,"company_name":"UNIVERSAL TECHNICAL INSTITUTE INC","country_code":"US","document_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/xslF345X06/ownership.xml","entity_uuid":"7a7a7872-4403-417d-bbfd-db90946d36dc","file_size":3591,"filing_date":"2026-09-30","filing_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/0001193125-26-409200-index.htm","filing_uuid":"00228a90-1d12-3a85-7f7e-dcf1636eb2ec","fiscal_period":null,"fiscal_year":null,"form_code":"4","form_label":"Statement of changes in beneficial ownership","form_type":"insider","has_financials":false,"is_amendment":false,"period_end":null,"reporting_currency":"USD","source_filing_id":"0001193125-26-409200","source_filing_id_type":"accession_number","source_system":"EDGAR","xbrl_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/ownership.xml"},{"accounting_standard":null,"company_name":"Live Oak Acquisition Corp. VI","country_code":"US","document_url":"https://www.sec.gov/Archives/edgar/data/2115191/000121390026105260/ea0306958-8k_live6.htm","entity_uuid":"88788dbe-414f-4629-b933-8ddba028c1fc","file_size":420046,"filing_date":"2026-09-30","filing_url":"https://www.sec.gov/Archives/edgar/data/2115191/000121390026105260/0001213900-26-105260-index.htm","filing_uuid":"00430618-4ae5-b237-332b-23a1bea2851b","fiscal_period":null,"fiscal_year":null,"form_code":"8-K","form_label":"Current report","form_type":"current","has_financials":false,"is_amendment":false,"period_end":null,"reporting_currency":"USD","source_filing_id":"0001213900-26-105260","source_filing_id_type":"accession_number","source_system":"EDGAR","xbrl_url":null}],"meta":{"filed_since":"2026-09-30","pagination":{"count":2,"next_cursor":"eyJkIjoiMjAyNi0wOS0zMCIsInUiOiIwMGE4Y2E2My1lYTRjLTZiMDMtMmVhZC05MjdkZDAyZWQwN2YifQ"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/id/{filing_uuid}":{"get":{"tags":["filings"],"summary":"A single filing by its filing_uuid","operationId":"filing_by_uuid_v1_filings_id__filing_uuid__get","parameters":[{"name":"filing_uuid","in":"path","required":true,"schema":{"type":"string","title":"Filing Uuid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"accounting_standard":null,"company_name":"UNIVERSAL TECHNICAL INSTITUTE INC","country_code":"US","document_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/xslF345X06/ownership.xml","entity_uuid":"7a7a7872-4403-417d-bbfd-db90946d36dc","file_size":3591,"filing_date":"2026-09-30","filing_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/0001193125-26-409200-index.htm","filing_uuid":"00228a90-1d12-3a85-7f7e-dcf1636eb2ec","fiscal_period":null,"fiscal_year":null,"form_code":"4","form_label":"Statement of changes in beneficial ownership","form_type":"insider","has_financials":false,"is_amendment":false,"period_end":null,"reporting_currency":"USD","source_filing_id":"0001193125-26-409200","source_filing_id_type":"accession_number","source_system":"EDGAR","xbrl_url":"https://www.sec.gov/Archives/edgar/data/1261654/000119312526409200/ownership.xml"},"meta":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{identifier}":{"get":{"tags":["filings"],"summary":"Filing history for a company","operationId":"company_filings_v1_filings__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"source_system","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated: EDGAR, ESEF, DART, EDINET, CVM, BSE, MOPS","title":"Source System"},"description":"Comma-separated: EDGAR, ESEF, DART, EDINET, CVM, BSE, MOPS"},{"name":"form_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated standardized types (full list: /v1/catalog/filing-forms)","title":"Form Type"},"description":"Comma-separated standardized types (full list: /v1/catalog/filing-forms)"},{"name":"form_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source-native form code (e.g. 10-K, 11011, DFP)","title":"Form Code"},"description":"Source-native form code (e.g. 10-K, 11011, DFP)"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"is_amendment","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Amendment"}},{"name":"has_financials","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Financials"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accounting_standard":null,"company_name":"Apple Inc.","country_code":"US","document_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/xslF345X06/form4.xml","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","file_size":3294,"filing_date":"2026-10-08","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/0001140361-26-039158-index.htm","filing_uuid":"d07ff531-3e42-10db-1413-d72cf52325f9","fiscal_period":null,"fiscal_year":null,"form_code":"4","form_label":"Statement of changes in beneficial ownership","form_type":"insider","has_financials":false,"is_amendment":false,"period_end":null,"reporting_currency":"USD","source_filing_id":"0001140361-26-039158","source_filing_id_type":"accession_number","source_system":"EDGAR","xbrl_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126039158/form4.xml"},{"accounting_standard":null,"company_name":"Apple Inc.","country_code":"US","document_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126038672/xslF345X06/form4.xml","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","file_size":13254,"filing_date":"2026-10-05","filing_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126038672/0001140361-26-038672-index.htm","filing_uuid":"f1baa5b0-4842-892b-fc54-e3731cb8e2cb","fiscal_period":null,"fiscal_year":null,"form_code":"4","form_label":"Statement of changes in beneficial ownership","form_type":"insider","has_financials":false,"is_amendment":false,"period_end":null,"reporting_currency":"USD","source_filing_id":"0001140361-26-038672","source_filing_id_type":"accession_number","source_system":"EDGAR","xbrl_url":"https://www.sec.gov/Archives/edgar/data/320193/000114036126038672/form4.xml"}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"next_cursor":"eyJkIjoiMjAyNi0xMC0wNSIsInUiOiJhY2U3Y2I0Ny1kYTFkLTMyNDUtMjgyYy1hMGFjM2ZlY2I4YmEifQ"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financials/{identifier}/income-statement":{"get":{"tags":["financials"],"summary":"Income statement","operationId":"income_statement_v1_financials__identifier__income_statement_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual|ttm)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Number of fiscal periods","default":8,"title":"Limit"},"description":"Number of fiscal periods"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"cost_of_revenue":220960000000.0,"currency":"USD","depreciation_amortization":11698000000.0,"ebit":null,"ebitda":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","eps_basic":7.49,"eps_diluted":7.46,"filing_date":"2025-10-31","filing_uuid":"aeb685c1-d404-2e24-0da9-70d78a5ac222","financial_result":null,"fiscal_period":"FY","fiscal_year":2025,"gross_profit":195201000000.0,"income_before_tax":132729000000.0,"income_from_continuing_ops":null,"income_tax_expense":20719000000.0,"interest_expense":null,"interest_income":null,"net_income":112010000000.0,"operating_expenses":62151000000.0,"operating_income":133050000000.0,"ordinary_income":null,"other_income_expense":-321000000.0,"period_end":"2025-09-27","research_development":34550000000.0,"revenue":416161000000.0,"selling_general_admin":27601000000.0,"source_system":"EDGAR","symbol":"AAPL","timeframe":"annual","weighted_avg_shares_basic":14948500000.0,"weighted_avg_shares_diluted":15004697000.0},{"cost_of_revenue":210352000000.0,"currency":"USD","depreciation_amortization":11445000000.0,"ebit":null,"ebitda":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","eps_basic":6.11,"eps_diluted":6.08,"filing_date":"2024-11-01","filing_uuid":"d37a3dea-18cf-ec0b-1845-190d7156ee96","financial_result":null,"fiscal_period":"FY","fiscal_year":2024,"gross_profit":180683000000.0,"income_before_tax":123485000000.0,"income_from_continuing_ops":null,"income_tax_expense":29749000000.0,"interest_expense":null,"interest_income":null,"net_income":93736000000.0,"operating_expenses":57467000000.0,"operating_income":123216000000.0,"ordinary_income":null,"other_income_expense":269000000.0,"period_end":"2024-09-28","research_development":31370000000.0,"revenue":391035000000.0,"selling_general_admin":26097000000.0,"source_system":"EDGAR","symbol":"AAPL","timeframe":"annual","weighted_avg_shares_basic":15343783000.0,"weighted_avg_shares_diluted":15408095000.0}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financials/{identifier}/balance-sheet":{"get":{"tags":["financials"],"summary":"Balance sheet","operationId":"balance_sheet_v1_financials__identifier__balance_sheet_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Number of fiscal periods","default":8,"title":"Limit"},"description":"Number of fiscal periods"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accounts_payable":69860000000.0,"accounts_receivable":39777000000.0,"accrued_liabilities":null,"accumulated_other_comprehensive_income":-5571000000.0,"additional_paid_in_capital":null,"cash_and_equivalents":35934000000.0,"common_stock":null,"currency":"USD","deferred_revenue_current":9055000000.0,"deferred_revenue_noncurrent":null,"deferred_tax_liabilities":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_date":"2025-10-31","filing_uuid":"aeb685c1-d404-2e24-0da9-70d78a5ac222","fiscal_period":"FY","fiscal_year":2025,"goodwill":null,"intangible_assets":null,"inventory":5718000000.0,"long_term_debt":78328000000.0,"long_term_investments":77723000000.0,"other_current_assets":14585000000.0,"other_current_liabilities":66387000000.0,"other_noncurrent_assets":83727000000.0,"other_noncurrent_liabilities":41549000000.0,"period_end":"2025-09-27","prepaid_expenses":null,"property_plant_equipment":49834000000.0,"retained_earnings":-14264000000.0,"shares_issued":14773260000.0,"shares_outstanding":14773260000.0,"short_term_debt":12350000000.0,"short_term_investments":18763000000.0,"source_system":"EDGAR","symbol":"AAPL","timeframe":"annual","total_assets":359241000000.0,"total_current_assets":147957000000.0,"total_current_liabilities":165631000000.0,"total_debt":null,"total_liabilities":285508000000.0,"total_liabilities_and_equity":359241000000.0,"total_stockholders_equity":73733000000.0,"treasury_stock":null},{"accounts_payable":68960000000.0,"accounts_receivable":33410000000.0,"accrued_liabilities":null,"accumulated_other_comprehensive_income":-7172000000.0,"additional_paid_in_capital":null,"cash_and_equivalents":29943000000.0,"common_stock":null,"currency":"USD","deferred_revenue_current":8249000000.0,"deferred_revenue_noncurrent":null,"deferred_tax_liabilities":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_date":"2024-11-01","filing_uuid":"d37a3dea-18cf-ec0b-1845-190d7156ee96","fiscal_period":"FY","fiscal_year":2024,"goodwill":null,"intangible_assets":null,"inventory":7286000000.0,"long_term_debt":85750000000.0,"long_term_investments":91479000000.0,"other_current_assets":14287000000.0,"other_current_liabilities":78304000000.0,"other_noncurrent_assets":74834000000.0,"other_noncurrent_liabilities":45888000000.0,"period_end":"2024-09-28","prepaid_expenses":null,"property_plant_equipment":45680000000.0,"retained_earnings":-19154000000.0,"shares_issued":15116786000.0,"shares_outstanding":15116786000.0,"short_term_debt":10912000000.0,"short_term_investments":35228000000.0,"source_system":"EDGAR","symbol":"AAPL","timeframe":"annual","total_assets":364980000000.0,"total_current_assets":152987000000.0,"total_current_liabilities":176392000000.0,"total_debt":null,"total_liabilities":308030000000.0,"total_liabilities_and_equity":364980000000.0,"total_stockholders_equity":56950000000.0,"treasury_stock":null}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financials/{identifier}/cash-flow":{"get":{"tags":["financials"],"summary":"Cash flow statement","operationId":"cash_flow_v1_financials__identifier__cash_flow_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual|ttm)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Number of fiscal periods","default":8,"title":"Limit"},"description":"Number of fiscal periods"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"acquisitions":null,"capital_expenditures":12715000000.0,"cash_from_financing":-120686000000.0,"cash_from_investing":15195000000.0,"cash_from_operations":111482000000.0,"change_in_inventory":-1400000000.0,"change_in_payables":902000000.0,"change_in_receivables":6682000000.0,"common_stock_repurchased":90711000000.0,"currency":"USD","debt_issuance":4481000000.0,"debt_repayment":10932000000.0,"deferred_income_taxes":null,"depreciation_amortization":11698000000.0,"dividends_paid":15421000000.0,"effect_of_fx":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_date":"2025-10-31","filing_uuid":"aeb685c1-d404-2e24-0da9-70d78a5ac222","fiscal_period":"FY","fiscal_year":2025,"free_cash_flow":98767000000.0,"net_change_in_cash":5991000000.0,"net_income":112010000000.0,"other_financing_activities":-111000000.0,"other_investing_activities":1480000000.0,"other_operating_activities":null,"period_end":"2025-09-27","purchases_of_investments":24407000000.0,"sales_of_investments":12890000000.0,"source_system":"EDGAR","stock_based_compensation":12863000000.0,"stock_issuance":null,"symbol":"AAPL","timeframe":"annual"},{"acquisitions":null,"capital_expenditures":9447000000.0,"cash_from_financing":-121983000000.0,"cash_from_investing":2935000000.0,"cash_from_operations":118254000000.0,"change_in_inventory":1046000000.0,"change_in_payables":6020000000.0,"change_in_receivables":3788000000.0,"common_stock_repurchased":94949000000.0,"currency":"USD","debt_issuance":0.0,"debt_repayment":9958000000.0,"deferred_income_taxes":null,"depreciation_amortization":11445000000.0,"dividends_paid":15234000000.0,"effect_of_fx":null,"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","filing_date":"2024-11-01","filing_uuid":"d37a3dea-18cf-ec0b-1845-190d7156ee96","fiscal_period":"FY","fiscal_year":2024,"free_cash_flow":108807000000.0,"net_change_in_cash":-794000000.0,"net_income":93736000000.0,"other_financing_activities":-361000000.0,"other_investing_activities":1308000000.0,"other_operating_activities":null,"period_end":"2024-09-28","purchases_of_investments":48656000000.0,"sales_of_investments":11135000000.0,"source_system":"EDGAR","stock_based_compensation":11688000000.0,"stock_issuance":null,"symbol":"AAPL","timeframe":"annual"}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/financials/{identifier}/metrics":{"get":{"tags":["financials"],"summary":"Selected metrics across periods","operationId":"metrics_series_v1_financials__identifier__metrics_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"metrics","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated standardized metric names (max 10), e.g. revenue,net_income","title":"Metrics"},"description":"Comma-separated standardized metric names (max 10), e.g. revenue,net_income"},{"name":"statement","in":"query","required":true,"schema":{"type":"string","pattern":"^(income-statement|balance-sheet|cash-flow|income_statement|balance_sheet|cash_flow)$","description":"income-statement | balance-sheet | cash-flow (underscore forms accepted — /v1/catalog/financial-metrics emits statement_type that way)","title":"Statement"},"description":"income-statement | balance-sheet | cash-flow (underscore forms accepted — /v1/catalog/financial-metrics emits statement_type that way)"},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Fiscal periods per metric","default":20,"title":"Limit"},"description":"Fiscal periods per metric"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"revenue":[{"fiscal_period":"FY","fiscal_year":2025,"unit":"USD","value":416161000000.0},{"fiscal_period":"FY","fiscal_year":2024,"unit":"USD","value":391035000000.0}]},"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ratios/{identifier}":{"get":{"tags":["ratios"],"summary":"Financial ratios by period, grouped by category","operationId":"get_ratios_v1_ratios__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual)$","default":"annual","title":"Period"}},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"Fiscal Year"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"default":8,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"filing_date":"2025-10-31","filing_uuid":"aeb685c1-d404-2e24-0da9-70d78a5ac222","fiscal_period":"FY","fiscal_year":2025,"period_end":"2025-09-27","ratios":{"cash_flow":{"capex_coverage":8.767754620526937,"capex_to_revenue":0.030553079216937677,"cash_flow_to_revenue":26.788190147563085,"cash_return_on_assets":30.786734988353004,"cash_to_income":0.995286135166503,"debt_payment_ratio":0.09806067347195063,"dividend_payment_ratio":0.1383272635941228,"fcf_to_debt":1.3696486468603188,"investing_financing_ratio":-0.9462603828420731,"reinvestment_ratio":0.11405428679069267},"efficiency":{"cash_conversion_cycle":-71.8217801776662,"days_inventory_outstanding":10.740541274438813,"days_payables_outstanding":114.65717776973209,"days_receivables_outstanding":32.09485631762708,"fixed_asset_turnover":8.71413614758046,"inventory_turnover":33.98338972623808,"operating_cycle":42.83539759206589,"payables_turnover":3.1834029678720643,"receivables_turnover":11.372538838864825,"total_asset_turnover":1.149265210481331,"working_capital_turnover":2.8665569163371862},"liquidity":{"cash_ratio":0.3302340745391865,"current_ratio":0.8932929222186667,"defensive_interval":868.9209344982381,"operating_cash_flow_ratio":0.6730744848488508,"quick_ratio":0.858770399261008,"working_capital":-17674000000.0},"profitability":{"ebitda":144748000000.0,"ebitda_margin":34.78173110887373,"effective_tax_rate":15.610002335586042,"fcf_margin":29.843498069256853,"gross_profit_margin":46.90516410716045,"net_profit_margin":26.91506412181824,"operating_profit_margin":31.970799762591884,"operating_roa":36.742927918411645,"pretax_margin":31.893666153243576,"rd_to_revenue":8.302075398703867,"return_on_assets":30.93254683307996,"return_on_common_equity":171.42244974480232,"roce":68.72062393471413,"roic":68.29281002639894,"rote":151.91298333175104,"sga_to_revenue":6.632288945864702},"solvency":{"debt_service_coverage":10.197768020490305,"debt_to_assets":0.2524155093655791,"debt_to_capital":0.5515324400435494,"debt_to_ebitda":0.6264542515267914,"debt_to_equity":1.229815686327696,"financial_leverage":4.8721874872852045,"fixed_charge_coverage":null,"interest_coverage":null,"long_term_debt_to_equity":1.0623194499070971},"ttm":{"eps_growth_yoy_ttm":0.2269736842105263,"eps_ttm":7.46,"revenue_growth_yoy_ttm":0.06425511782832749,"revenue_ttm":416161000000.0},"valuation":{"buyback_yield":0.017714733056691113,"enterprise_value":5175396945190.0,"ev_ebitda":35.75453163560118,"ev_fcf":41.67086922542413,"ev_sales":12.436045052731995,"fcf_yield":0.024254133472697535,"pb_ratio":69.44859079638697,"pcf_ratio":45.93255364265083,"pe_ratio":45.74664879356568,"peg_ratio":2.015504526557097,"pfcf_ratio":41.23008563161751,"ps_ratio":12.304499809424717,"total_shareholder_yield":0.02072626306371599}},"timeframe":"annual"},{"filing_date":"2024-11-01","filing_uuid":"d37a3dea-18cf-ec0b-1845-190d7156ee96","fiscal_period":"FY","fiscal_year":2024,"period_end":"2024-09-28","ratios":{"cash_flow":{"capex_coverage":12.517624642743728,"capex_to_revenue":0.02415896275269477,"cash_flow_to_revenue":30.24128274962599,"cash_return_on_assets":32.95989341702401,"cash_to_income":1.2615643936161134,"debt_payment_ratio":0.08420856799769987,"dividend_payment_ratio":0.12882439494647116,"fcf_to_debt":1.3211086052430117,"investing_financing_ratio":-1.0067143606135944,"reinvestment_ratio":0.07988736110406414},"efficiency":{"cash_conversion_cycle":-72.97163939376223,"days_inventory_outstanding":11.814018882634821,"days_payables_outstanding":114.15012693009812,"days_receivables_outstanding":29.364468653701074,"fixed_asset_turnover":8.748475865540579,"inventory_turnover":30.895498274216052,"operating_cycle":41.17848753633589,"payables_turnover":3.1975435316293104,"receivables_turnover":12.429988238659844,"total_asset_turnover":1.0898973330564703,"working_capital_turnover":2.9287501123460857},"liquidity":{"cash_ratio":0.36946686924577077,"current_ratio":0.8673125765340832,"defensive_interval":971.6925365862147,"operating_cash_flow_ratio":0.6704045534944896,"quick_ratio":0.8260068483831466,"working_capital":-23405000000.0},"profitability":{"ebitda":134661000000.0,"ebitda_margin":34.43707085043538,"effective_tax_rate":24.091185164189984,"fcf_margin":32.65717902489547,"gross_profit_margin":46.206349815233935,"net_profit_margin":23.971255769943866,"operating_profit_margin":31.510222870075566,"operating_roa":34.34290787011036,"pretax_margin":31.57901466620635,"rd_to_revenue":8.022299794136075,"return_on_assets":26.12620773367635,"return_on_common_equity":157.41250755692886,"roce":65.33607652660827,"roic":60.88834549910923,"rote":164.59350307287096,"sga_to_revenue":6.673827151022286},"solvency":{"debt_service_coverage":11.87527615987146,"debt_to_assets":0.2648419091457066,"debt_to_capital":0.629260734838424,"debt_to_ebitda":0.7178173338977135,"debt_to_equity":1.6973134328358208,"financial_leverage":6.408779631255487,"fixed_charge_coverage":null,"interest_coverage":null,"long_term_debt_to_equity":1.5057067603160668},"ttm":{"eps_growth_yoy_ttm":-0.008156606851549727,"eps_ttm":6.08,"revenue_growth_yoy_ttm":0.02021994077514111,"revenue_ttm":391035000000.0},"valuation":{"buyback_yield":0.018056905915816757,"enterprise_value":5325039580650.0,"ev_ebitda":39.544037105398,"ev_fcf":41.69927863250875,"ev_sales":13.617808075108366,"fcf_yield":0.024285510562046107,"pb_ratio":92.33223144249341,"pcf_ratio":44.46632317426894,"pe_ratio":56.129934210526315,"peg_ratio":null,"pfcf_ratio":41.17681600496472,"ps_ratio":13.44718651949314,"total_shareholder_yield":0.020954028631396202}},"timeframe":"annual"}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ratios/{identifier}/history":{"get":{"tags":["ratios"],"summary":"Time series of selected ratios","operationId":"ratio_history_v1_ratios__identifier__history_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"ratios","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated ratio names (max 10), e.g. pe_ratio,debt_to_equity","title":"Ratios"},"description":"Comma-separated ratio names (max 10), e.g. pe_ratio,debt_to_equity"},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(annual|quarterly|semiannual)$","default":"annual","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"description":"Fiscal periods per ratio","default":20,"title":"Limit"},"description":"Fiscal periods per ratio"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"pe_ratio":[{"fiscal_period":"FY","fiscal_year":2025,"period_end":"2025-09-27","value":45.74664879356568},{"fiscal_period":"FY","fiscal_year":2024,"period_end":"2024-09-28","value":56.129934210526315}]},"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"period":"annual"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/economy/indicators/{indicator_code}":{"get":{"tags":["economy"],"summary":"Indicator observation history","operationId":"indicator_history_v1_economy_indicators__indicator_code__get","parameters":[{"name":"indicator_code","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Indicator Code"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"revision","in":"query","required":false,"schema":{"type":"string","pattern":"^(latest|all)$","default":"latest","title":"Revision"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Observations (or observation-revisions with revision=all)","default":120,"title":"Limit"},"description":"Observations (or observation-revisions with revision=all)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"is_final":true,"is_preliminary":false,"observation_date":"2026-04-01","observation_value":0.099,"revision_number":0},{"is_final":true,"is_preliminary":false,"observation_date":"2026-01-01","observation_value":-0.0091,"revision_number":0}],"meta":{"pagination":{"count":2,"next_cursor":"eyJkIjoiMjAyNS0wNC0wMSIsInIiOjB9"},"revision":"latest","series":{"base_year":null,"category":"growth","concept":"gdp_contrib_gfcf","country_code":"AT","currency":null,"description":"Contribution of gross fixed capital formation to quarterly real GDP growth, percentage points","first_date":"2010-01-01","frequency":"quarterly","indicator_code":"AT_GDP_CONTRIB_GFCF","indicator_name":"Austria GDP Contribution: Fixed Investment","latest_date":"2026-04-01","metric":"pp contribution (QoQ)","obs_count":66,"seasonal_adjustment":"seasonally_adjusted","subcategory":"Growth Contributions"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/economy/calendar":{"get":{"tags":["economy"],"summary":"Scheduled economic releases and central-bank events","operationId":"calendar_v1_economy_calendar_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: today","title":"From"},"description":"Default: today"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: from + 14 days","title":"To"},"description":"Default: from + 14 days"},{"name":"importance","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(low|medium|high)$"},{"type":"null"}],"title":"Importance"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"industrial","central_bank":null,"country_code":"JP","currency":"JPY","event_name":"Japan Machinery Orders","event_type":"data_release","forecast_value":null,"has_press_conference":false,"importance":"medium","indicator_code":null,"indicator_name":"Japan Machinery Orders","is_completed":false,"meeting_type":null,"scheduled_date":"2026-10-15","scheduled_datetime":"2026-10-14T23:50:00+00:00","scheduled_time":"08:50:00","timezone":"Asia/Tokyo"},{"category":"industrial","central_bank":null,"country_code":"JP","currency":"JPY","event_name":"Japan Industrial Production","event_type":"data_release","forecast_value":null,"has_press_conference":false,"importance":"medium","indicator_code":null,"indicator_name":"Japan Industrial Production","is_completed":false,"meeting_type":null,"scheduled_date":"2026-10-15","scheduled_datetime":"2026-10-15T04:30:00+00:00","scheduled_time":"13:30:00","timezone":"Asia/Tokyo"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/economy/releases/latest":{"get":{"tags":["economy"],"summary":"Latest observation per indicator, by category","operationId":"latest_releases_v1_economy_releases_latest_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","description":"One of: main, gdp, prices, labour, housing, money, trade, consumer, business, fiscal, energy, central_bank_rates","default":"main","title":"Category"},"description":"One of: main, gdp, prices, labour, housing, money, trade, consumer, business, fiscal, energy, central_bank_rates"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"headline","country_code":"US","frequency":"monthly","indicator_code":"US_CPI_YOY","indicator_name":"Inflation Rate (CPI)","is_final":false,"is_preliminary":true,"metric":"% Change YoY","observation_date":"2026-08-01","observation_value":3.35302,"subcategory":"Prices"},{"category":"headline","country_code":"US","frequency":"quarterly","indicator_code":"US_CURRENT_ACCOUNT_BALANCE","indicator_name":"Current Account Balance","is_final":true,"is_preliminary":false,"metric":"Billions of Dollars, SAAR","observation_date":"2026-04-01","observation_value":-1024.973,"subcategory":"Trade"}],"meta":{"category":"main","count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/sovereign":{"get":{"tags":["rates"],"summary":"Sovereign benchmark yields cross-section","operationId":"sovereign_cross_section_v1_rates_sovereign_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"tenor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"description":"Maturity label, e.g. 2Y, 10Y","title":"Tenor"},"description":"Maturity label, e.g. 2Y, 10Y"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Latest observation on or before this date (default: today)","title":"Date"},"description":"Latest observation on or before this date (default: today)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"as_of_date":"2026-10-07","country_code":"AU","currency":"AUD","maturity_label":"2Y","rate_name":"Australia 2Y Govt Bond","rate_value":4.94,"series_id":"AU_2Y_GOVT","term_years":2},{"as_of_date":"2026-10-07","country_code":"AU","currency":"AUD","maturity_label":"3Y","rate_name":"Australia 3Y Govt Bond","rate_value":4.933,"series_id":"AU_3Y_GOVT","term_years":3}],"meta":{"count":2,"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/yield-curve":{"get":{"tags":["rates"],"summary":"Full yield curve for one country","operationId":"yield_curve_v1_rates_yield_curve_get","parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":2,"description":"ISO2, e.g. US, DE, JP","title":"Country"},"description":"ISO2, e.g. US, DE, JP"},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"as_of_date":"2026-10-14","currency":"USD","maturity_label":"1M","rate_value":4.11,"series_id":"US_1M_GOVT","term_years":0.0833},{"as_of_date":"2026-10-14","currency":"USD","maturity_label":"6W","rate_value":4.15,"series_id":"US_6W_GOVT","term_years":0.125}],"meta":{"count":2,"country":"US","unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/yields":{"get":{"tags":["rates"],"summary":"Sovereign yields (cross-section or history)","description":"Default: latest observation per series (current-yields cross-section).\nWith from/to: historical observations across matching series.","operationId":"yields_v1_rates_yields_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"maturity","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"description":"Maturity label, e.g. 2Y, 10Y","title":"Maturity"},"description":"Maturity label, e.g. 2Y, 10Y"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"AU","currency":"AUD","date":"2026-10-07","maturity":"2Y","name":"Australia 2Y Govt Bond","series_id":"AU_2Y_GOVT","term_years":2,"value":4.94},{"country_code":"AU","currency":"AUD","date":"2026-10-07","maturity":"3Y","name":"Australia 3Y Govt Bond","series_id":"AU_3Y_GOVT","term_years":3,"value":4.933}],"meta":{"count":2,"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/overnight":{"get":{"tags":["rates"],"summary":"Overnight risk-free rates (cross-section or history)","description":"Default: latest value per rate (SOFR, ESTR, SONIA, TONA, CORRA, ...).\nWith from/to: historical observations.","operationId":"overnight_v1_rates_overnight_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"AU","currency":"AUD","date":"2026-10-13","name":"AUD Overnight Index Average","series_id":"AONIA","value":4.6},{"country_code":"BR","currency":"BRL","date":"2026-10-13","name":"Brazil Interbank Deposit Rate (CDI)","series_id":"CDI","value":13.65}],"meta":{"count":2,"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/policy":{"get":{"tags":["rates"],"summary":"Central bank policy rates (cross-section or history)","description":"Decision-grain policy rates (long format; euro-area countries carry the\nECB rows). Default: the standing rate per country and rate_type — unlike\nthe market-rate cross-sections there is NO staleness window, because a\npolicy rate remains in force regardless of decision age. With from/to:\ndecision history; change_bps is populated on policy_rate rows only.","operationId":"policy_rates_v1_rates_policy_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"rate_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(policy_rate|policy_floor|policy_middle|policy_ceiling|all)$","description":"Corridor leg; policy_rate is the headline anchor for every bank","default":"policy_rate","title":"Rate Type"},"description":"Corridor leg; policy_rate is the headline anchor for every bank"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"central_bank_id":"ECB","central_bank_name":"European Central Bank","change_bps":25,"country_code":"AT","country_name":"Austria","effective_date":"2026-09-16","rate_label":"Deposit Facility Rate","rate_percent":2.5,"rate_type":"policy_rate"},{"central_bank_id":"RBA","central_bank_name":"Reserve Bank of Australia","change_bps":25,"country_code":"AU","country_name":"Australia","effective_date":"2026-05-06","rate_label":"Cash Rate Target","rate_percent":4.35,"rate_type":"policy_rate"}],"meta":{"count":2,"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/spreads":{"get":{"tags":["rates"],"summary":"Yield spreads — every tenor combination per country","description":"Spread = longer-tenor yield minus shorter-tenor yield, in percentage\npoints. Default: latest value per pair (cross-section). With from/to:\nhistorical values for the matching pair(s).","operationId":"spreads_v1_rates_spreads_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"long","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"description":"Longer-tenor leg, e.g. 10Y","title":"Long"},"description":"Longer-tenor leg, e.g. 10Y"},{"name":"short","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"description":"Shorter-tenor leg, e.g. 2Y","title":"Short"},"description":"Shorter-tenor leg, e.g. 2Y"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"AU","date":"2026-10-07","long_maturity":"10Y","series_id":"AU_10Y_2Y","short_maturity":"2Y","value":0.464},{"country_code":"AU","date":"2026-10-07","long_maturity":"10Y","series_id":"AU_10Y_3Y","short_maturity":"3Y","value":0.471}],"meta":{"count":2,"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/series/{series_id}/history":{"get":{"tags":["rates"],"summary":"Rate series history","operationId":"series_history_v1_rates_series__series_id__history_get","parameters":[{"name":"series_id","in":"path","required":true,"schema":{"type":"string","maxLength":40,"title":"Series Id"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"as_of_date":"2026-10-13","rate_value":4.6},{"as_of_date":"2026-10-12","rate_value":4.6}],"meta":{"count":2,"series":{"category":"overnight","country_code":"AU","currency":"AUD","description":"AUD Overnight Index Average (AONIA), AU overnight reference rate.","frequency":"daily","maturity_label":"Overnight","series_id":"AONIA","series_name":"AUD Overnight Index Average","series_type":"overnight","term_years":null,"unit":"percent"},"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/spreads/{series_id}/history":{"get":{"tags":["rates"],"summary":"Rate spread history","description":"History for any cataloged spread series_id: tenor pairs\n({ISO2}_{LONG}_{SHORT}, computed from the yields view) or curated\ndefinitions (cross-country, credit, breakeven).","operationId":"spread_history_v1_rates_spreads__series_id__history_get","parameters":[{"name":"series_id","in":"path","required":true,"schema":{"type":"string","maxLength":40,"title":"Series Id"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":500,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"as_of_date":"2026-10-07","spread_value":2.402},{"as_of_date":"2026-10-06","spread_value":2.407}],"meta":{"count":2,"spread":{"category":"breakeven","country":"AU","description":"Nominal minus indexed 10Y — Australian inflation expectations","leg_a_series_id":"AU_10Y_GOVT","leg_b_series_id":"AU_10Y_INDEXED","series_id":"AU_10Y_BREAKEVEN","series_name":"Australia 10Y Breakeven"},"unit":"percent"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rates/metrics":{"get":{"tags":["rates"],"summary":"Daily change/volatility metrics for a rate series","operationId":"rate_metrics_v1_rates_metrics_get","parameters":[{"name":"series_id","in":"query","required":true,"schema":{"type":"string","maxLength":40,"title":"Series Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Most recent N days","default":1,"title":"Limit"},"description":"Most recent N days"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"52w_high":4.6,"52w_low":3.6,"as_of_date":"2026-10-13","chg_10y_bp":310.0,"chg_1d_bp":0.0,"chg_1m_bp":25.0,"chg_1w_bp":0.0,"chg_1y_bp":100.0,"chg_3m_bp":25.0,"chg_5y_bp":457.0,"chg_ytd_bp":100.0,"series_id":"AONIA","vol_30d_bp":72.46,"vol_90d_bp":41.83},{"52w_high":4.6,"52w_low":3.6,"as_of_date":"2026-10-12","chg_10y_bp":310.0,"chg_1d_bp":0.0,"chg_1m_bp":25.0,"chg_1w_bp":0.0,"chg_1y_bp":100.0,"chg_3m_bp":25.0,"chg_5y_bp":457.0,"chg_ytd_bp":100.0,"series_id":"AONIA","vol_30d_bp":72.46,"vol_90d_bp":41.83}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insiders/transactions":{"get":{"tags":["insiders"],"summary":"Firehose: all insider transactions by filing date","operationId":"firehose_v1_insiders_transactions_get","parameters":[{"name":"filed_since","in":"query","required":true,"schema":{"type":"string","format":"date","description":"Filings on or after this date (your last sync point)","title":"Filed Since"},"description":"Filings on or after this date (your last sync point)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accession_number":"0001477932-26-005918","acquired_or_disposed":"acquired","cik_issuer":"0001921865","cik_owner":"0002011790","entity_uuid":"34fed6ad-0723-4c05-a138-18b4443c901d","filing_date":"2026-09-30","issuer_name":"ASP Isotopes Inc.","owner_name":"Ryan Robert John Andrew","ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"533bf052-a59b-4bc7-b544-e64d7cefeb3d","shares_owned_after":660222.0,"symbol":"ASPI","transaction_code":"P","transaction_date":"2026-09-28","transaction_price_per_share":2.7,"transaction_shares":8000.0,"transaction_value":21600.0},{"accession_number":"0001171843-26-006301","acquired_or_disposed":"acquired","cik_issuer":"0001342338","cik_owner":"0002112814","entity_uuid":"8e424b94-66c1-409c-ad31-8cade73c1e17","filing_date":"2026-09-30","issuer_name":"Himax Technologies, Inc.","owner_name":"Pan Ming-Feng","ownership_type":"direct","security_title":"Ordinary shares, par value at US$0.3 per share","security_type":"common_stock","security_uuid":"71af3cc1-c169-4237-ad0c-d8a79417a733","shares_owned_after":129372.0,"symbol":"HIMX","transaction_code":"M","transaction_date":"2026-09-30","transaction_price_per_share":0.0,"transaction_shares":3916.0,"transaction_value":0.0}],"meta":{"filed_since":"2026-09-30","pagination":{"count":2,"next_cursor":"eyJkIjoiMjAyNi0wOS0zMCIsImlkIjo5MjUxNzh9"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insiders/transactions/{identifier}":{"get":{"tags":["insiders"],"summary":"Insider transactions for an issuer","operationId":"issuer_transactions_v1_insiders_transactions__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated transaction codes: P=purchase, S=sale, M=option exercise, A=grant, G=gift, F=tax withholding, ... (full list: /v1/catalog/insider-transaction-codes)","title":"Code"},"description":"Comma-separated transaction codes: P=purchase, S=sale, M=option exercise, A=grant, G=gift, F=tax withholding, ... (full list: /v1/catalog/insider-transaction-codes)"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accession_number":"0001140361-26-039158","acquired_or_disposed":"disposed","cik_issuer":"0000320193","cik_owner":"0001780525","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","owner_name":"Newstead Jennifer","ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares_owned_after":39593.0,"symbol":"AAPL","transaction_code":"S","transaction_date":"2026-10-06","transaction_price_per_share":332.01,"transaction_shares":2399.0,"transaction_value":796491.99},{"accession_number":"0001140361-26-038669","acquired_or_disposed":"disposed","cik_issuer":"0000320193","cik_owner":"0002148403","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","owner_name":"Ternus John","ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares_owned_after":59567.0,"symbol":"AAPL","transaction_code":"S","transaction_date":"2026-10-02","transaction_price_per_share":334.05,"transaction_shares":3754.0,"transaction_value":1254023.7}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"next_cursor":"eyJkIjoiMjAyNi0xMC0wMiIsImlkIjo5NDQ5NDd9"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insiders/holdings/{identifier}":{"get":{"tags":["insiders"],"summary":"Current insider holdings for an issuer","operationId":"issuer_holdings_v1_insiders_holdings__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"cik_owner":"0001214128","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","is_director":false,"is_officer":false,"is_ten_percent_owner":false,"last_transaction_date":"2026-05-27","officer_title":null,"owner_name":"LEVINSON ARTHUR D","ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares_owned":3699576.0,"symbol":"AAPL"},{"cik_owner":"0001214156","entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","is_director":false,"is_officer":false,"is_ten_percent_owner":false,"last_transaction_date":"2026-10-02","officer_title":"Executive Chair","owner_name":"COOK TIMOTHY D","ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares_owned":3237843.0,"symbol":"AAPL"}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/insiders/{cik_owner}":{"get":{"tags":["insiders"],"summary":"Insider profile: relationships and holdings","operationId":"insider_profile_v1_insiders__cik_owner__get","parameters":[{"name":"cik_owner","in":"path","required":true,"schema":{"type":"string","maxLength":10,"title":"Cik Owner"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"holdings":[{"cik_issuer":"0001921865","entity_uuid":"34fed6ad-0723-4c05-a138-18b4443c901d","last_transaction_date":"2026-09-30","officer_title":null,"ownership_type":"direct","security_title":"Common Stock","security_type":"common_stock","security_uuid":"533bf052-a59b-4bc7-b544-e64d7cefeb3d","shares_owned":675222.0,"symbol":"ASPI"}],"insider":{"cik_owner":"0002011790","name":"Ryan Robert John Andrew"},"relationships":[{"cik_issuer":"0001921865","first_reported_date":null,"is_director":false,"is_officer":false,"is_ten_percent_owner":false,"last_reported_date":null,"officer_title":null,"relationship_status":"active","ticker":"ASPI"}]},"meta":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/congress/trades":{"get":{"tags":["congress"],"summary":"Congressional trades (Senate + House PTRs)","operationId":"trades_v1_congress_trades_get","parameters":[{"name":"chamber","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(senate|house)$"},{"type":"null"}],"title":"Chamber"}},{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":12},{"type":"null"}],"title":"Ticker"}},{"name":"member","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"description":"Name fragment","title":"Member"},"description":"Name fragment"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":50000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"amount_range":"$1,001 - $15,000","amount_range_high":15000.0,"amount_range_low":1001.0,"asset_description":"Home Depot, Inc. (HD) [ST]","asset_type":"stock","bioguide_id":"L000560","chamber":"house","disclosure_url":"https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20035635.pdf","filing_date":"2026-10-12","first_name":"Rick","last_name":"Larsen","owner":"self","party":"Democrat","party_short":"D","security_type":"common_stock","security_uuid":"5503e73a-6f72-49a5-b3bb-60090a128342","state":"WA","state_district":"WA:2","term_end":"2027-01-03","term_start":"2025-01-03","ticker":"HD","transaction_date":"2026-10-08","transaction_type":"sale"},{"amount_range":"$1,001 - $15,000","amount_range_high":15000.0,"amount_range_low":1001.0,"asset_description":"FedEx Corporation Common Stock","asset_type":"stock","bioguide_id":"L000560","chamber":"house","disclosure_url":"https://disclosures-clerk.house.gov/public_disc/ptr-pdfs/2026/20035635.pdf","filing_date":"2026-10-12","first_name":"Rick","last_name":"Larsen","owner":"self","party":"Democrat","party_short":"D","security_type":"common_stock","security_uuid":"f0d379b1-dcf9-4f45-a799-40a167975731","state":"WA","state_district":"WA:2","term_end":"2027-01-03","term_start":"2025-01-03","ticker":"FDX","transaction_date":"2026-10-08","transaction_type":"sale"}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/congress/members":{"get":{"tags":["congress"],"summary":"Members of Congress","operationId":"members_v1_congress_members_get","parameters":[{"name":"chamber","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(senate|house)$"},{"type":"null"}],"title":"Chamber"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"State"}},{"name":"party","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Party"}},{"name":"active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"bioguide_id":"B001265","chamber":"senate","district":null,"first_name":"Mark","full_name":"Mark Begich","is_active":false,"last_name":"Begich","party":"Democrat","state":"AK","term_end":"2015-01-03","term_start":"2009-01-06"},{"bioguide_id":"B001323","chamber":"house","district":0,"first_name":"Nicholas","full_name":"Nicholas J. Begich III","is_active":true,"last_name":"Begich","party":"Republican","state":"AK","term_end":"2027-01-03","term_start":"2025-01-03"}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/congress/members/{bioguide_id}/trades":{"get":{"tags":["congress"],"summary":"Trades by one member","operationId":"member_trades_v1_congress_members__bioguide_id__trades_get","parameters":[{"name":"bioguide_id","in":"path","required":true,"schema":{"type":"string","maxLength":12,"title":"Bioguide Id"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":50000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"member":{"bioguide_id":"B001265","chamber":"senate","district":null,"first_name":"Mark","full_name":"Mark Begich","is_active":false,"last_name":"Begich","party":"Democrat","state":"AK"},"trades":[]},"meta":{"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds":{"get":{"tags":["funds"],"summary":"Fund directory / search","operationId":"search_funds_v1_funds_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Name, registrant, family, or class-ticker search","title":"Q"},"description":"Name, registrant, family, or class-ticker search"},{"name":"fund_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":25},{"type":"null"}],"title":"Fund Type"}},{"name":"fund_structure","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Fund Structure"}},{"name":"fund_sub_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":15},{"type":"null"}],"title":"Fund Sub Type"}},{"name":"asset_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Asset Class"}},{"name":"fund_family","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Fund Family"}},{"name":"management_style","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(?i)(active|passive)$"},{"type":"null"}],"title":"Management Style"}},{"name":"is_index_fund","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Index Fund"}},{"name":"is_esg_focused","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Esg Focused"}},{"name":"geographic_focus","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Geographic Focus"}},{"name":"cik","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Restrict to one registrant's funds","title":"Cik"},"description":"Restrict to one registrant's funds"},{"name":"status","in":"query","required":false,"schema":{"type":"string","pattern":"^(active|inactive|all)$","default":"active","title":"Status"}},{"name":"min_net_assets","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Net Assets"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"net_assets|total_assets|expense_ratio|aum_change_1y|fund_name","default":"net_assets","title":"Sort"},"description":"net_assets|total_assets|expense_ratio|aum_change_1y|fund_name"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"asset_class":"EQUITY","cik":"0000036405","expense_ratio":null,"fund_family":"Vanguard Group, Inc.","fund_name":"Vanguard Total Stock Market Index Fund","fund_structure":"OPEN_END","fund_sub_type":null,"fund_type":"ETF","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","holdings_count":null,"is_active":true,"is_index_fund":true,"management_style":"PASSIVE","net_assets":2297839156547.89,"period_end":"2026-06-30","primary_benchmark":"CRSP US Total Market Index","registrant_name":"Vanguard Index Funds","series_id":"S000002848","total_assets":2299997814240.02},{"asset_class":"EQUITY","cik":"0000036405","expense_ratio":null,"fund_family":"Vanguard Group, Inc.","fund_name":"Vanguard 500 Index Fund","fund_structure":"OPEN_END","fund_sub_type":null,"fund_type":"ETF","fund_uuid":"f9c3a2ba-2e92-5e95-a7b1-ba6b3d411d8a","holdings_count":null,"is_active":true,"is_index_fund":true,"management_style":"PASSIVE","net_assets":1671231561960.14,"period_end":"2026-06-30","primary_benchmark":"S&P 500 Index","registrant_name":"Vanguard Index Funds","series_id":"S000002839","total_assets":1673632288919.41}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}":{"get":{"tags":["funds"],"summary":"Fund profile","operationId":"fund_profile_v1_funds__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"asset_class":"EQUITY","aum_change_1m":null,"aum_change_1y":null,"aum_change_3m":null,"cik":"0000036405","entity_uuid":"1c692db2-0fc0-4b36-955d-61510ed62f80","expense_ratio":null,"fiscal_year_end":"12-31","fund_family":"Vanguard Group, Inc.","fund_name":"Vanguard Total Stock Market Index Fund","fund_structure":"OPEN_END","fund_sub_type":null,"fund_type":"ETF","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","geographic_focus":"US","holdings_count":null,"holdings_period_end":null,"investment_objective":"Investment Objective\n\nVanguard Total Stock Market Index Fund (the “Fund”) seeks to track the performance of a benchmark index that measures the investment return of the overall stock market.\n\nVanguard Total Stock Market ETF, an exchange-traded share class of Vanguard Total Stock …","investment_style":"Core","is_active":true,"is_esg_focused":false,"is_index_fund":true,"management_style":"PASSIVE","market_cap_focus":"All Cap","net_assets":2297839156547.89,"num_classes":6,"period_end":"2026-06-30","portfolio_turnover":null,"primary_adviser_name":"The Vanguard Group, Inc.","primary_benchmark":"CRSP US Total Market Index","registrant_name":"Vanguard Index Funds","sector_focus":"Diversified","series_id":"S000002848","series_lei":"HJ2RZRUQEVF2A5SPRB21","strategy_type":"Passive Index","top_10_pct":null,"top_20_pct":null,"total_assets":2299997814240.02,"tracks_benchmark":true,"ultimate_parent_entity_uuid":"9966c10c-aa8d-425c-a47e-68541f976933","ultimate_parent_name":"THE VANGUARD GROUP, INC."},"meta":{"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/classes":{"get":{"tags":["funds"],"summary":"Share classes (tickers, fees, returns)","operationId":"fund_classes_v1_funds__identifier__classes_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"is_tradeable","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Tradeable"}},{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"acquired_fund_fees":null,"cik":"0000036405","class_id":"C000007807","class_kind":"SHARE_CLASS","class_name":"Vanguard Morningstar Total Stock Market Index Fund Institutional Shares","contract_gross_premiums":null,"contract_gross_premiums_1035":null,"contract_num_affected":null,"contract_num_affected_redeemed":null,"contract_num_sold":null,"contract_report_period":null,"contract_total_asset":null,"contract_value_redeemed":null,"contract_value_redeemed_1035":null,"distribution_12b1_fee":0,"entity_uuid":"1c692db2-0fc0-4b36-955d-61510ed62f80","expense_ratio":0.0003,"fee_waiver":null,"fee_waiver_termination_date":null,"fees_filing_date":"2026-04-28","fees_form_type":"485BPOS","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","highest_quarterly_return":0.221,"highest_quarterly_return_date":"2020-06-30","inception_date":null,"is_active":true,"is_tradeable":true,"latest_monthly_return":-0.33192758,"latest_monthly_return_month":"2026-06-01","lowest_quarterly_return":-0.2086,"lowest_quarterly_return_date":"2020-03-31","management_fee":0.0003,"max_account_fee":null,"max_deferred_charge":null,"max_sales_charge":0,"net_expenses":null,"other_expenses":0.0,"portfolio_turnover_rate":null,"redemption_fee":0,"return_10yr":null,"return_1yr":null,"return_5yr":null,"return_after_tax_distributions_10yr":null,"return_after_tax_distributions_1yr":null,"return_after_tax_distributions_5yr":null,"return_after_tax_sales_10yr":null,"return_after_tax_sales_1yr":null,"return_after_tax_sales_5yr":null,"return_since_inception":null,"returns_filing_date":"2026-04-28","security_uuid":"c28ac730-8faa-4abb-81e1-c2d48152d4c0","series_id":"S000002848","share_class":"INSTITUTIONAL","ticker":"VITSX","total_annual_expenses":0.0003},{"acquired_fund_fees":null,"cik":"0000036405","class_id":"C000155407","class_kind":"SHARE_CLASS","class_name":"Vanguard Morningstar Total Stock Market Index Fund Institutional Plus Shares","contract_gross_premiums":null,"contract_gross_premiums_1035":null,"contract_num_affected":null,"contract_num_affected_redeemed":null,"contract_num_sold":null,"contract_report_period":null,"contract_total_asset":null,"contract_value_redeemed":null,"contract_value_redeemed_1035":null,"distribution_12b1_fee":0,"entity_uuid":"1c692db2-0fc0-4b36-955d-61510ed62f80","expense_ratio":0.0002,"fee_waiver":null,"fee_waiver_termination_date":null,"fees_filing_date":"2026-04-28","fees_form_type":"485BPOS","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","highest_quarterly_return":null,"highest_quarterly_return_date":null,"inception_date":null,"is_active":true,"is_tradeable":true,"latest_monthly_return":-0.32917309,"latest_monthly_return_month":"2026-06-01","lowest_quarterly_return":null,"lowest_quarterly_return_date":null,"management_fee":0.0002,"max_account_fee":null,"max_deferred_charge":null,"max_sales_charge":0,"net_expenses":null,"other_expenses":0.0,"portfolio_turnover_rate":null,"redemption_fee":0,"return_10yr":0.1426,"return_1yr":0.1715,"return_5yr":0.1309,"return_after_tax_distributions_10yr":null,"return_after_tax_distributions_1yr":null,"return_after_tax_distributions_5yr":null,"return_after_tax_sales_10yr":null,"return_after_tax_sales_1yr":null,"return_after_tax_sales_5yr":null,"return_since_inception":null,"returns_filing_date":"2026-04-28","security_uuid":"3e5c1add-c628-456d-8ada-d7cd4041f8d8","series_id":"S000002848","share_class":"INSTITUTIONAL PLUS","ticker":"VSMPX","total_annual_expenses":0.0002}],"meta":{"count":2,"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/managers":{"get":{"tags":["funds"],"summary":"Portfolio managers","operationId":"fund_managers_v1_funds__identifier__managers_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"as_of_date":"2026-04-28","credentials":null,"employer_name":"Vanguard Capital Management","is_lead":false,"manager_name":"Walter Nejman","manager_since":"2016-01-01","responsibility":null,"since_text":"2016","team":null,"title":"Portfolio Manager"},{"as_of_date":"2026-04-28","credentials":null,"employer_name":"Vanguard","is_lead":false,"manager_name":"Michelle Louie","manager_since":"2023-01-01","responsibility":null,"since_text":"2023","team":null,"title":"Principal and Portfolio Manager"}],"meta":{"count":2,"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/strategy":{"get":{"tags":["funds"],"summary":"Full strategy block","operationId":"fund_strategy_v1_funds__identifier__strategy_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"analysis_style":null,"credit_quality":null,"duration_focus":null,"factor_exposures":null,"fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","is_concentrated":false,"is_diversified":true,"is_factor_based":false,"is_hedged":false,"is_long_short":false,"is_market_neutral":false,"is_non_diversified":false,"peer_group_benchmark":null,"principal_strategy_text":"The Fund employs an indexing investment approach designed to track the performance of the CRSP US Total Market Index (the “Target Index”), which represents 100% of the investable U.S. stock market, as determined by the index provider. The Target Index includes large-, mid-, small…","rebalancing_frequency":null,"secondary_benchmark":"Dow Jones US Total Stock Market Float Adjusted Index","series_id":"S000002848","strategy_approach":"INDEX","strategy_orientation":"Return-Oriented","strategy_tags":["diversified","tax-efficient"],"uses_derivatives":false,"uses_leverage":false,"uses_short_selling":false,"value_substyle":null},"meta":{"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/portfolio":{"get":{"tags":["funds"],"summary":"Portfolio look-through analytics","operationId":"fund_portfolio_v1_funds__identifier__portfolio_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"cash_pct":0.007,"country_allocation":{"DK":0.0,"US":1.0},"debt_pct":null,"debt_to_equity":0.3347,"derivative_pct":0.0001,"eps_growth":0.3229,"equity_pct":0.993,"fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","gross_value_usd":2308950274713.79,"holdings_period_end":"2026-06-30","intl_pct":0.0,"large_cap_pct":0.3455,"long_pct":0.9999,"mega_cap_pct":0.573,"micro_cap_pct":0.0018,"mid_cap_pct":0.0555,"net_margin":0.2266,"other_pct":null,"pb_ratio":4.7107,"pe_ratio":16.8402,"positions_count":3546,"ps_ratio":2.7799,"revenue_growth":0.1439,"roe":0.2723,"sector_allocation":{"Communication Services":0.0147,"Consumer Discretionary":0.117,"Consumer Staples":0.0198,"Energy":0.0248,"Financials":0.1049,"Healthcare":0.0859,"Industrials":0.107,"Materials":0.034,"Real Estate":0.0232,"Technology":0.4392,"Utilities":0.0294},"short_pct":null,"small_cap_pct":0.0242,"total_value_usd":2308724575755.41,"us_pct":1.0,"wtd_avg_market_cap":1421022823374.79,"wtd_avg_maturity_years":null,"wtd_median_market_cap":315024730197.0},"meta":{"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/holdings":{"get":{"tags":["funds"],"summary":"Fund portfolio holdings","operationId":"fund_holdings_v1_funds__identifier__holdings_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: the fund's latest filed period; see /holdings/periods","title":"Period End"},"description":"Default: the fund's latest filed period; see /holdings/periods"},{"name":"position_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Position Type"}},{"name":"asset_category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":50},{"type":"null"}],"title":"Asset Category"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"asset_category":"EC","asset_category_name":"Equity - Common Stock","balance":729853903.0,"balance_unit":"NS","counterparty_name":null,"derivative_category":null,"derivative_type":null,"fair_value_usd":146036467451.27,"investment_country_code":"US","is_restricted_security":false,"issuer_name":"NVIDIA Corp","lei":"549300S4KLFTLO7GSQ80","maturity_date":null,"notional_amount":null,"payoff_profile":"Long","pct_of_nav":6.355382,"period_end":"2026-06-30","position_type":"security","security_title":"NVIDIA CORP","security_uuid":"20e2e000-1945-4082-81a3-9a927aeb3182","ticker":"NVDA","unrealized_gain_loss":null},{"asset_category":"EC","asset_category_name":"Equity - Common Stock","balance":466272244.0,"balance_unit":"NS","counterparty_name":null,"derivative_category":null,"derivative_type":null,"fair_value_usd":134920536523.84,"investment_country_code":"US","is_restricted_security":false,"issuer_name":"Apple Inc","lei":"HWUPKR0MPOU8FGXBT394","maturity_date":null,"notional_amount":null,"payoff_profile":"Long","pct_of_nav":5.871627,"period_end":"2026-06-30","position_type":"security","security_title":"APPLE INC","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","ticker":"AAPL","unrealized_gain_loss":null}],"meta":{"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}},"pagination":{"count":2,"limit":5,"offset":0},"period_end":"2026-06-30"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/holdings/periods":{"get":{"tags":["funds"],"summary":"Available N-PORT filing periods","operationId":"fund_holding_periods_v1_funds__identifier__holdings_periods_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":["2026-06-30","2026-03-31"],"meta":{"count":2,"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/flows":{"get":{"tags":["funds"],"summary":"Monthly fund flows","operationId":"fund_flows_v1_funds__identifier__flows_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":240,"minimum":1,"default":36,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"is_quarter_end":true,"month_date":"2026-06-01","net_assets":2297839156547.89,"net_flow":3683244569.0901,"net_realized_gain":2509402570.23,"net_unrealized_appreciation":-13036057700.98,"period_end":"2026-06-30","redemptions":21666695416.99,"reinvestments":4280680709.27,"sales":21069259276.8101,"total_assets":2299997814240.02,"total_liabilities":2158657692.13},{"is_quarter_end":false,"month_date":"2026-05-01","net_assets":null,"net_flow":-7731956758.48,"net_realized_gain":-21631883.32,"net_unrealized_appreciation":110977618158.39,"period_end":"2026-06-30","redemptions":21077911128.43,"reinvestments":67.49,"sales":13345954302.46,"total_assets":null,"total_liabilities":null}],"meta":{"count":2,"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/returns":{"get":{"tags":["funds"],"summary":"Fund returns (monthly N-PORT or calendar-year)","operationId":"fund_returns_v1_funds__identifier__returns_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"frequency","in":"query","required":false,"schema":{"type":"string","pattern":"^(monthly|annual)$","default":"monthly","title":"Frequency"}},{"name":"class_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":12},{"type":"null"}],"title":"Class Id"}},{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"Restrict to one class by its ticker","title":"Ticker"},"description":"Restrict to one class by its ticker"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2400,"minimum":1,"default":120,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"class_id":"C000007805","month_date":"2026-06-01","total_return":-0.3341308},{"class_id":"C000007806","month_date":"2026-06-01","total_return":-0.32898064}],"meta":{"frequency":"monthly","identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/funds/{identifier}/service-providers":{"get":{"tags":["funds"],"summary":"Service providers (custodians, advisers, agents…)","operationId":"fund_service_providers_v1_funds__identifier__service_providers_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"provider_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Provider Type"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"US","is_affiliated":false,"is_registrant_level":false,"is_sub":true,"lei":"7H6GLXDRUGQFU57RNE97","name":"Jpmorgan Chase Bank, N.A.","ord":21,"provider_type":"ADMINISTRATOR","report_period":"2025-12-31","state_code":"NY"},{"country_code":"US","is_affiliated":true,"is_registrant_level":false,"is_sub":false,"lei":"5493002789CX3L0CJP65","name":"The Vanguard Group, Inc.","ord":22,"provider_type":"ADMINISTRATOR","report_period":"2025-12-31","state_code":"PA"}],"meta":{"identifier":{"requested":"ad1912cd-c9dd-c382-c98f-43a4c010d534","resolved":{"fund_name":"Vanguard Total Stock Market Index Fund","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","matched_as":"fund_uuid","series_id":"S000002848"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/holdings/security/{identifier}":{"get":{"tags":["funds"],"summary":"Funds holding a security (N-PORT reverse lookup)","operationId":"security_fund_holders_v1_holdings_security__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: each fund's own latest portfolio (period_end disclosed per row)","title":"Period End"},"description":"Default: each fund's own latest portfolio (period_end disclosed per row)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"balance":466272244.0,"cik":"0000036405","fair_value_usd":134920536523.84,"fund_family":"Vanguard Group, Inc.","fund_name":"Vanguard Total Stock Market Index Fund","fund_type":"ETF","fund_uuid":"ad1912cd-c9dd-c382-c98f-43a4c010d534","pct_of_nav":5.871627,"period_end":"2026-06-30","position_type":"security","registrant_name":"Vanguard Index Funds","series_id":"S000002848"},{"balance":380610709.0,"cik":"0000036405","fair_value_usd":110133514756.24,"fund_family":"Vanguard Group, Inc.","fund_name":"Vanguard 500 Index Fund","fund_type":"ETF","fund_uuid":"f9c3a2ba-2e92-5e95-a7b1-ba6b3d411d8a","pct_of_nav":6.589961,"period_end":"2026-06-30","position_type":"security","registrant_name":"Vanguard Index Funds","series_id":"S000002839"}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/institutions/{cik}/positions":{"get":{"tags":["funds"],"summary":"An institution's 13F positions","operationId":"institution_positions_v1_institutions__cik__positions_get","parameters":[{"name":"cik","in":"path","required":true,"schema":{"type":"string","title":"Cik"}},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: the manager's latest filed quarter","title":"Period End"},"description":"Default: the manager's latest filed quarter"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"investment_discretion":"shared-defined","issuer_name":"Apple Inc.","market_value_usd":65950296923,"put_call":null,"security_type":"common_stock","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","shares":227917808,"symbol":"AAPL","title_of_class":"COM","voting_authority_none":0,"voting_authority_shared":0,"voting_authority_sole":227917808},{"investment_discretion":"shared-defined","issuer_name":"AMERICAN EXPRESS CO","market_value_usd":51282319275,"put_call":null,"security_type":"common_stock","security_uuid":"65371dd3-cd05-4844-88bc-6683d48101da","shares":151610700,"symbol":"AXP","title_of_class":"COM","voting_authority_none":0,"voting_authority_shared":0,"voting_authority_sole":151610700}],"meta":{"pagination":{"count":2,"limit":5,"offset":0},"period_end":"2026-06-30"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/institutions/holders/{identifier}":{"get":{"tags":["funds"],"summary":"Institutions holding a security (13F reverse lookup)","operationId":"security_institutional_holders_v1_institutions_holders__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: most-populated recent quarter","title":"Period End"},"description":"Default: most-populated recent quarter"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"entity_cik":"0002012383","entity_name":"BlackRock, Inc.","market_value_usd":336524794350,"put_call":null,"shares":1162996939,"title_of_class":"COM"},{"entity_cik":"0002100119","entity_name":"VANGUARD CAPITAL MANAGEMENT, LLC","market_value_usd":277527465127,"put_call":null,"shares":959107911,"title_of_class":"COM"}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"limit":5,"offset":0},"period_end":"2026-06-30"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers":{"get":{"tags":["advisers"],"summary":"Adviser directory / screener","operationId":"search_advisers_v1_advisers_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Business- or legal-name search","title":"Q"},"description":"Business- or legal-name search"},{"name":"registration_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(registered|exempt_reporting)$"},{"type":"null"}],"title":"Registration Type"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Principal-office ISO-2 country","title":"Country"},"description":"Principal-office ISO-2 country"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Principal-office US state","title":"State"},"description":"Principal-office US state"},{"name":"min_raum","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Raum"}},{"name":"max_raum","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Max Raum"}},{"name":"client_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Comma-separated Item 5.D client types the adviser serves (AND). One or more of: banks, bdcs, charities, corporations, govt_entities, hnw_individuals, individuals, insurance_companies, investment_companies, other_advisers, other_clients, pension_plans, pooled_vehicles, sovereign_wealth","title":"Client Type"},"description":"Comma-separated Item 5.D client types the adviser serves (AND). One or more of: banks, bdcs, charities, corporations, govt_entities, hnw_individuals, individuals, insurance_companies, investment_companies, other_advisers, other_clients, pension_plans, pooled_vehicles, sovereign_wealth"},{"name":"has_private_funds","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Private Funds"}},{"name":"has_disciplinary_history","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Has Disciplinary History"}},{"name":"cik","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Exact EDGAR CIK (cross-link from 13F / filings)","title":"Cik"},"description":"Exact EDGAR CIK (cross-link from 13F / filings)"},{"name":"lei","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":20,"maxLength":20},{"type":"null"}],"title":"Lei"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"raum_total|accounts_total|employee_count_total|client_count_total|latest_filing_date|business_name","default":"raum_total","title":"Sort"},"description":"raum_total|accounts_total|employee_count_total|client_count_total|latest_filing_date|business_name"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accounts_total":228,"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","cik":"0000102909","client_count_total":0,"employee_count_total":1702,"entity_uuid":"9966c10c-aa8d-425c-a47e-68541f976933","has_disciplinary_history":true,"has_private_funds":false,"latest_filing_date":"2026-09-21","legal_name":"THE VANGUARD GROUP, INC.","lei":"5493002789CX3L0CJP65","office_city":"MALVERN","office_country_code":"US","office_state":"PA","raum_total":11092665107962,"registration_type":"registered","sec_file_number":"801-11953","website":"https://www.vanguard.com"},{"accounts_total":128,"adviser_crd_number":338002,"business_name":"Vanguard Capital Management, LLC","cik":"0002100119","client_count_total":0,"employee_count_total":235,"entity_uuid":"0877293d-d34e-4819-93f2-60fb95c08027","has_disciplinary_history":true,"has_private_funds":false,"latest_filing_date":"2026-09-21","legal_name":"VANGUARD CAPITAL MANAGEMENT, LLC","lei":"529900ZEWTRLEJ6XE960","office_city":"MALVERN","office_country_code":"US","office_state":"PA","raum_total":8436181597982,"registration_type":"registered","sec_file_number":"801-134586","website":null}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}":{"get":{"tags":["advisers"],"summary":"Adviser profile (Form ADV Part 1 snapshot)","operationId":"adviser_profile_v1_advisers__crd__get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"accounts_discretionary":228,"accounts_non_discretionary":0,"accounts_total":228,"activity_financial_planning":false,"activity_market_timing":false,"activity_other":false,"activity_pension_consulting":false,"activity_portfolio_mgmt_individuals":false,"activity_portfolio_mgmt_institutional":false,"activity_portfolio_mgmt_investment_companies":true,"activity_portfolio_mgmt_pooled_vehicles":false,"activity_selection_of_other_advisers":true,"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","cik":"0000102909","client_count_total":0,"comp_commissions":false,"comp_fixed_fees":false,"comp_hourly":false,"comp_other":true,"comp_pct_of_aum":true,"comp_performance_based":false,"comp_subscription":false,"custody_client_count":null,"custody_raum_amount":null,"disciplinary_civil":true,"disciplinary_criminal":false,"disciplinary_regulatory":true,"employee_count_advisory":19,"employee_count_iars":0,"employee_count_total":1702,"entity_uuid":"9966c10c-aa8d-425c-a47e-68541f976933","fiscal_year_end_month":"DECEMBER","has_custody_of_client_cash":false,"has_custody_of_client_securities":false,"has_disciplinary_history":true,"has_private_funds":false,"has_sma_raum":false,"is_umbrella_registration":false,"item5_fiscal_year":2025,"latest_filing_date":"2026-09-21","legal_name":"THE VANGUARD GROUP, INC.","lei":"5493002789CX3L0CJP65","office_city":"MALVERN","office_country_code":"US","office_phone":"610-669-1000","office_postal":"19355","office_state":"PA","office_street_1":"100 VANGUARD BLVD","office_street_2":null,"organization_country_code":"US","organization_form":"Corporation","organization_state":"PA","other_office_count":0,"participates_in_wrap_fee_program":false,"raum_discretionary":11092665107962,"raum_non_discretionary":0,"raum_non_us":0,"raum_total":11092665107962,"registration_type":"registered","sec_file_number":"801-11953","serves_banks":false,"serves_bdcs":false,"serves_charities":false,"serves_corporations":false,"serves_govt_entities":false,"serves_hnw_individuals":false,"serves_individuals":false,"serves_insurance_companies":false,"serves_investment_companies":true,"serves_other_advisers":false,"serves_other_clients":false,"serves_pension_plans":false,"serves_pooled_vehicles":false,"serves_sovereign_wealth":false,"website":"https://www.vanguard.com"},"meta":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/owners":{"get":{"tags":["advisers"],"summary":"Owners & executive officers (Schedules A/B)","operationId":"adviser_owners_v1_advisers__crd__owners_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"ownership_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(direct|indirect)$"},{"type":"null"}],"title":"Ownership Type"}},{"name":"owner_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(individual|domestic_entity|foreign_entity)$"},{"type":"null"}],"title":"Owner Type"}},{"name":"control_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: control persons only","title":"Control Only"},"description":"true: control persons only"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"entity_in_which":null,"is_control_person":true,"is_public_reporting":false,"owner_crd":"5606776","owner_name":"Angell, Jacqueline, Mary","owner_type":"individual","ownership_code":"NA","ownership_code_label":"Less than 5% (or executive officer with no ownership)","ownership_type":"direct","public_company_cik":null,"public_company_name":null,"schedule":"A","status_acquired":"2022-11-01","title_or_status":"Chief Compliance Officer"},{"entity_in_which":null,"is_control_person":true,"is_public_reporting":false,"owner_crd":"6931980","owner_name":"Bendl, John, Wesley","owner_type":"individual","ownership_code":"NA","ownership_code_label":"Less than 5% (or executive officer with no ownership)","ownership_type":"direct","public_company_cik":null,"public_company_name":null,"schedule":"A","status_acquired":"2025-07-01","title_or_status":"Managing Director and Chief Financial Officer"}],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/private-funds":{"get":{"tags":["advisers"],"summary":"Private funds advised (Schedule D 7.B.1)","operationId":"adviser_private_funds_v1_advisers__crd__private_funds_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"fund_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"e.g. Hedge Fund, Private Equity Fund, Venture Capital Fund","title":"Fund Type"},"description":"e.g. Hedge Fund, Private Equity Fund, Venture Capital Fund"},{"name":"min_gav","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Minimum gross asset value","title":"Min Gav"},"description":"Minimum gross asset value"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/fund-providers":{"get":{"tags":["advisers"],"summary":"Private-fund service providers (auditors, prime brokers, custodians…)","operationId":"adviser_fund_providers_v1_advisers__crd__fund_providers_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"role","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(auditor|prime_broker|custodian|administrator|marketer)$"},{"type":"null"}],"title":"Role"}},{"name":"reference_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Restrict to one fund (reference_id from /private-funds)","title":"Reference Id"},"description":"Restrict to one fund (reference_id from /private-funds)"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/registered-funds":{"get":{"tags":["advisers"],"summary":"Registered-fund mandates (Schedule D 5.G(3))","operationId":"adviser_registered_funds_v1_advisers__crd__registered_funds_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/disciplinary":{"get":{"tags":["advisers"],"summary":"Disciplinary events (DRPs filed against the firm)","operationId":"adviser_disciplinary_v1_advisers__crd__disciplinary_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(regulatory|civil|criminal)$"},{"type":"null"}],"title":"Event Type"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"date_initiated lower bound","title":"From"},"description":"date_initiated lower bound"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"allegations":"THE SOUTH KOREAN FINANCIAL SUPERVISORY SERVICE (\"FSS\") CLAIMED THAT ON DECEMBER 10, 2021, THE VANGUARD GROUP, INC. (\"VGI\") ENGAGED IN THE SALE OF ONE SOUTH KOREAN LISTED SECURITY WITHOUT CORRESPONDING OWNERSHIP OF THE POSITION, A PRACTICE WHICH IS PROHIBITED UNDER SOUTH KOREAN LA…","case_number":"CAPITAL MARKETS INVESTIGATION GENERAL DIVISION - 1524","court":null,"date_initiated":"2026-07-08","disposition":null,"drp_reference_id":"1813988","event_type":"regulatory","has_monetary_sanction":true,"initiated_by":"FINANCIAL SERVICES COMMISSION, SOUTH KOREA","initiator_type":"Foreign","is_felony":null,"monetary_amount":710,"other_sanctions_text":null,"principal_product":"Equity Listed (Common & Preferred Stock)","principal_sanction":"Civil and Administrative Penalt(ies) /Fine(s)","resolution":"Decision & Order of Offer of Settlement","resolution_date":"2026-08-07","sanction_bar":false,"sanction_cease_and_desist":false,"sanction_censure":false,"sanction_disgorgement":false,"sanction_revocation":false,"sanction_suspension":false,"status":"Final","status_date":null,"summary":"ON JULY 8, 2026, THE SOUTH KOREAN FINANCIAL SERVICES COMMISSION IMPOSED AN ADMINISTRATIVE FINE IN THE AMOUNT OF ~$710 USD (KRW 1 MILLION) ON VGI IN CONNECTION WITH ONE INCIDENT DURING 2021 IN WHICH VGI SOLD A SOUTH KOREAN LISTED SECURITY WITHOUT CORRESPONDING OWNERSHIP OF THE POS…"},{"allegations":"ON DECEMBER 10, 2025, THE MARYLAND SECURITIES COMMISSIONER ISSUED A SETTLED CONSENT ORDER IN WHICH IT FOUND THAT (I) THE VANGUARD GROUP (\"VGI\") VIOLATED MARYLAND SECURITIES ACT SECTION 11-301(2), BY FAILING TO DISCLOSE THE POTENTIAL FOR HIGHER CAPITAL GAINS DISTRIBUTIONS FROM LOW…","case_number":"SECURITIES DOCKET NO 2022-0022","court":null,"date_initiated":"2025-12-10","disposition":null,"drp_reference_id":"1813969","event_type":"regulatory","has_monetary_sanction":true,"initiated_by":"MARYLAND SECURITIES COMMISSIONER","initiator_type":"State","is_felony":null,"monetary_amount":166700000,"other_sanctions_text":"ORDER TO CEASE AND DESIST FROM FUTURE VIOLATIONS OF ANY APPLICABLE LAWS.","principal_product":"Mutual Fund(s)","principal_sanction":"Civil and Administrative Penalt(ies) /Fine(s)","resolution":"Settled","resolution_date":"2025-12-10","sanction_bar":false,"sanction_cease_and_desist":true,"sanction_censure":false,"sanction_disgorgement":true,"sanction_revocation":false,"sanction_suspension":false,"status":"Final","status_date":null,"summary":"THE ALLEGATIONS, DISPOSITION, FINDINGS, AND SANCTIONS OF THE ORDER ARE DESCRIBED IN ITEMS 7 AND 12."}],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/advisers/{crd}/aum-history":{"get":{"tags":["advisers"],"summary":"AUM / scale history (point-in-time Item 5 panel)","operationId":"adviser_aum_history_v1_advisers__crd__aum_history_get","parameters":[{"name":"crd","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"IAPD/FINRA CRD number","title":"Crd"},"description":"IAPD/FINRA CRD number"},{"name":"from_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"From Year"}},{"name":"to_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"To Year"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accounts_discretionary":212,"accounts_non_discretionary":0,"accounts_total":212,"employee_count_advisory":330,"employee_count_total":651,"filing_date":"2025-03-28","filing_uuid":"cb99aff6-e7cf-76fb-1638-7f5054d2f1b4","fiscal_year":2024,"raum_discretionary":10246600000000,"raum_non_discretionary":0,"raum_total":10246600000000,"registration_type":"registered"},{"accounts_discretionary":228,"accounts_non_discretionary":0,"accounts_total":228,"employee_count_advisory":19,"employee_count_total":1702,"filing_date":"2026-03-30","filing_uuid":"cca457c5-7200-c582-f803-d676e0824216","fiscal_year":2025,"raum_discretionary":11092665107962,"raum_non_discretionary":0,"raum_total":11092665107962,"registration_type":"registered"}],"meta":{"adviser":{"adviser_crd_number":105958,"business_name":"Vanguard Group Inc","registration_type":"registered"},"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans":{"get":{"tags":["pensions"],"summary":"Pension plan directory / screener","operationId":"search_plans_v1_pensions_plans_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"Plan- or sponsor-name search","title":"Q"},"description":"Plan- or sponsor-name search"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"State"}},{"name":"universe","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(public_ppd|erisa)$"},{"type":"null"}],"title":"Universe"}},{"name":"plan_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(public_db|single_employer|multiple_employer|multiemployer)$"},{"type":"null"}],"title":"Plan Type"}},{"name":"plan_category_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1},{"type":"null"}],"description":"PPD peer category 1-5","title":"Plan Category Code"},"description":"PPD peer category 1-5"},{"name":"plan_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(active|closed|restricted|frozen|terminated)$"},{"type":"null"}],"title":"Plan Status"}},{"name":"ein","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sponsor EIN (9 digits) — lists all of a sponsor's plans","title":"Ein"},"description":"Sponsor EIN (9 digits) — lists all of a sponsor's plans"},{"name":"system_entity_uuid","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Member plans of one retirement system","title":"System Entity Uuid"},"description":"Member plans of one retirement system"},{"name":"sponsor_ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":12},{"type":"null"}],"description":"Listed sponsor ticker — a ticker's pension plans","title":"Sponsor Ticker"},"description":"Listed sponsor ticker — a ticker's pension plans"},{"name":"sponsor_cik","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Sponsor EDGAR CIK","title":"Sponsor Cik"},"description":"Sponsor EDGAR CIK"},{"name":"min_funded_ratio","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Funded Ratio"}},{"name":"max_funded_ratio","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Max Funded Ratio"}},{"name":"funded_ratio_basis","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Basis pin for the funded-ratio band: gasb25|gasb67|ppa_ftap|rpa. Rows on other bases are excluded when pinned — bases are never silently compared.","title":"Funded Ratio Basis"},"description":"Basis pin for the funded-ratio band: gasb25|gasb67|ppa_ftap|rpa. Rows on other bases are excluded when pinned — bases are never silently compared."},{"name":"min_total_assets","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Total Assets"}},{"name":"max_total_assets","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Max Total Assets"}},{"name":"min_expected_return","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Min Expected Return"}},{"name":"max_expected_return","in":"query","required":false,"schema":{"anyOf":[{"type":"number","maximum":1,"minimum":0},{"type":"null"}],"title":"Max Expected Return"}},{"name":"min_net_cash_flow_ratio","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Net Cash Flow Ratio"}},{"name":"max_net_cash_flow_ratio","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Net Cash Flow Ratio"}},{"name":"zone_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"description":"Multiemployer zone, e.g. critical_and_declining","title":"Zone Status"},"description":"Multiemployer zone, e.g. critical_and_declining"},{"name":"benefit_restriction_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"Single-employer AFTAP status: none|restricted_80|frozen_60","title":"Benefit Restriction Status"},"description":"Single-employer AFTAP status: none|restricted_80|frozen_60"},{"name":"distress_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Equable band (GASB-basis public plans only): resilient|fragile|distressed","title":"Distress Tier"},"description":"Equable band (GASB-basis public plans only): resilient|fragile|distressed"},{"name":"has_risk_transfer","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Any PRT event in the plan's history","title":"Has Risk Transfer"},"description":"Any PRT event in the plan's history"},{"name":"is_collectively_bargained","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Collectively Bargained"}},{"name":"ids","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated entity_uuids (batch fetch, max 100)","title":"Ids"},"description":"Comma-separated entity_uuids (batch fetch, max 100)"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"total_assets|funded_ratio|unfunded_liability|total_participants|net_cash_flow_ratio|expected_return|latest_period_end|plan_name","default":"total_assets","title":"Sort"},"description":"total_assets|funded_ratio|unfunded_liability|total_participants|net_cash_flow_ratio|expected_return|latest_period_end|plan_name"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"distress_tier_latest":"fragile","ein":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","financials_as_of":"2025-06-30","funded_ratio_basis":"gasb25","funded_ratio_latest":0.71313,"plan_name":"California PERF","plan_number":null,"plan_status":"active","plan_type":"public_db","ppd_id":9,"sponsor_name":"California","sponsor_ticker":null,"state":"CA","system_entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","total_assets_basis":"ppd_market","total_assets_latest":562975808000.0,"total_participants_latest":2233774,"unfunded_liability_latest":186594848000.0,"universe":"public_ppd","zone_status":null},{"distress_tier_latest":"fragile","ein":null,"entity_uuid":"2fbad32b-a612-43ee-959d-7238c3d07aa6","financials_as_of":"2025-06-30","funded_ratio_basis":"gasb25","funded_ratio_latest":0.76697,"plan_name":"California Teachers","plan_number":null,"plan_status":"active","plan_type":"public_db","ppd_id":10,"sponsor_name":"California","sponsor_ticker":null,"state":"CA","system_entity_uuid":"4f87dbf0-b65e-40a3-65a6-bc11388949b9","total_assets_basis":"gasb67_net_position","total_assets_latest":370180000000.0,"total_participants_latest":1040301,"unfunded_liability_latest":88668992000.0,"universe":"public_ppd","zone_status":null}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}":{"get":{"tags":["pensions"],"summary":"Pension plan profile","operationId":"plan_profile_v1_pensions_plans__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"active_participants_latest":924062,"actives_to_retirees_ratio":1.3480962336076514,"actuary_name_latest":"Internal actuarial services","administering_gov":"state","audit_opinion_code_latest":null,"auditor_name_latest":null,"benefit_restriction_status":null,"business_code":null,"contribution_basis_latest":null,"contribution_vs_required_ratio_latest":null,"covered_payroll_latest":null,"discount_rate_latest":0.068,"distress_tier_latest":"fragile","ein":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","erisa_total_expense_ratio_latest":null,"established_date":null,"expected_return_latest":0.068,"filings_count":null,"financials_as_of":"2025-06-30","financials_source":"ppd_gasb","first_period_end":null,"funded_ratio_basis":"gasb25","funded_ratio_latest":0.71313,"funding_deficiency_latest":null,"has_risk_transfer":false,"inception_year":1932,"investment_consultant_latest":"Wilshire","investment_expense_ratio_latest":0.003320805216553817,"is_collectively_bargained":null,"is_final_filing":null,"is_limited_scope_audit_latest":null,"latest_form":null,"latest_period_end":null,"liability_basis":"gasb25_aal","liability_latest":650446656000.0,"liability_maturity_basis":"ppd_pvfb","liability_maturity_ratio":0.5108442502239492,"look_through_required_latest":null,"manager_count_latest":null,"net_cash_flow_ratio_latest":-0.009123113155157105,"participants_as_of":"2025-06-30","pbgc_covered_code":null,"plan_category":"pers_ers","plan_category_code":"1","plan_closed":false,"plan_full_name":"California Public Employees Retirement Fund","plan_name":"California PERF","plan_number":null,"plan_status":"active","plan_type":"public_db","plan_year_closed":null,"pooled_exposure_ratio_latest":null,"ppd_id":9,"provider_fees_total_latest":null,"retired_participants_latest":685457,"return_1yr_latest":0.116,"social_security_covered":true,"sponsor_cik":null,"sponsor_entity_uuid":null,"sponsor_name":"California","sponsor_ticker":null,"state":"CA","system_entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","total_assets_basis":"ppd_market","total_assets_latest":562975808000.0,"total_participants_latest":2233774,"unfunded_liability_latest":186594848000.0,"universe":"public_ppd","withdrawal_liability_latest":null,"zone_status":null},"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/financials":{"get":{"tags":["pensions"],"summary":"Plan-year financials — five measurement regimes, basis-honest","operationId":"plan_financials_v1_pensions_plans__identifier__financials_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"basis","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Project one regime family: gasb|ppa|rpa|sch_h|sf|sch_i. Omitted = all families side by side. Never rank or YoY across regimes.","title":"Basis"},"description":"Project one regime family: gasb|ppa|rpa|sch_h|sf|sch_i. Omitted = all families side by side. Never rank or YoY across regimes."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"actuarial_accrued_liability":650446656000.0,"actuarial_assets":463851808000.0,"actuarial_assets_is_estimated":null,"actuarial_liability_is_estimated":null,"admin_expenses":363655000.0,"benefit_payments":34602108000.0,"benefit_payments_cola":null,"contribution_ratio":null,"contribution_standard":null,"covered_payroll":null,"employee_contributions":6801588000.0,"employer_contributions":23421228000.0,"employer_contributions_own":23421228000.0,"employer_contributions_state_aid":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","fair_value_change":54961816000.0,"fiduciary_net_position":null,"fiscal_year":2025,"funded_ratio":0.71313,"funded_ratio_is_estimated":null,"funded_ratio_market":null,"investment_expenses":1869533000.0,"investment_income":8301137000.0,"issued_pension_obligation_bond":false,"market_assets_adjustment":null,"mb_assets_current_value":null,"mb_current_liability":null,"mb_funded_ratio":null,"mb_funding_deficiency":null,"mb_normal_cost":null,"mb_required_contribution":null,"mb_withdrawal_liability":null,"mb_zone_status":null,"net_cash_flow":-5136092000.0,"net_investment_result":61480456000.0,"net_pension_liability":null,"pbgc_covered_code":null,"pension_obligation_bond_proceeds":null,"period_end":"2025-06-30","period_end_is_estimated":false,"pvf_salaries":null,"pvfb_retiree":393914932690.0,"pvfb_total":771105738231.0,"pvfc_total":null,"pvfnc_total":120444053239.0,"refunds_and_withdrawals":393145000.0,"required_contribution":null,"required_contribution_is_estimated":null,"sb_adjusted_ftap":null,"sb_assets_actuarial":null,"sb_assets_market":null,"sb_benefit_restriction_status":null,"sb_carryover_balance_boy":null,"sb_employee_contributions":null,"sb_employer_contributions":null,"sb_ftap":null,"sb_funding_target":null,"sb_funding_target_active_vested":null,"sb_funding_target_retired":null,"sb_funding_target_term_vested":null,"sb_minimum_required_contribution":null,"sb_prefunding_balance_boy":null,"sb_unpaid_minimum_all_years":null,"sch_h_actuarial_fees":null,"sch_h_admin_expenses":null,"sch_h_audit_fees":null,"sch_h_audit_opinion_code":null,"sch_h_benefit_payments":null,"sch_h_custodial_fees":null,"sch_h_employee_contributions":null,"sch_h_employer_contributions":null,"sch_h_investment_mgmt_fees":null,"sch_h_is_limited_scope_audit":null,"sch_h_legal_fees":null,"sch_h_net_assets":null,"sch_h_net_income":null,"sch_h_total_assets":null,"sch_h_total_assets_boy":null,"sch_h_total_contributions":null,"sch_h_total_income":null,"sch_h_total_liabilities":null,"sch_h_transfers_from":null,"sch_h_transfers_to":null,"sch_i_admin_expenses":null,"sch_i_audit_waived":null,"sch_i_benefit_payments":null,"sch_i_employee_contributions":null,"sch_i_employer_contributions":null,"sch_i_net_assets":null,"sch_i_net_assets_boy":null,"sch_i_net_income":null,"sch_i_total_assets":null,"sch_i_total_expenses":null,"sch_i_total_income":null,"sch_i_total_liabilities":null,"sch_i_transfers":null,"securities_lending_net":87036000.0,"sf_admin_expenses":null,"sf_benefit_payments":null,"sf_db_funding_required":null,"sf_employer_contrib_paid":null,"sf_employer_contributions":null,"sf_funding_deficiency":null,"sf_net_assets":null,"sf_net_assets_boy":null,"sf_net_income":null,"sf_other_contributions":null,"sf_other_expenses":null,"sf_participant_contributions":null,"sf_required_contribution":null,"sf_total_assets":null,"sf_total_expenses":null,"sf_total_income":null,"sf_total_liabilities":null,"sf_transfers":null,"sf_unpaid_minimum_current_year":null,"total_assets":562975808000.0,"total_assets_boy":506622976000.0,"total_contributions":30222816000.0,"total_pension_liability":null,"unfunded_liability":186594848000.0},{"actuarial_accrued_liability":650446656000.0,"actuarial_assets":463851808000.0,"actuarial_assets_is_estimated":null,"actuarial_liability_is_estimated":null,"admin_expenses":378941000.0,"benefit_payments":32815644000.0,"benefit_payments_cola":null,"contribution_ratio":null,"contribution_standard":null,"covered_payroll":null,"employee_contributions":6389252000.0,"employer_contributions":24868492000.0,"employer_contributions_own":24868492000.0,"employer_contributions_state_aid":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","fair_value_change":38350528000.0,"fiduciary_net_position":null,"fiscal_year":2024,"funded_ratio":0.71313,"funded_ratio_is_estimated":null,"funded_ratio_market":null,"investment_expenses":1645966000.0,"investment_income":7543213000.0,"issued_pension_obligation_bond":false,"market_assets_adjustment":null,"mb_assets_current_value":null,"mb_current_liability":null,"mb_funded_ratio":null,"mb_funding_deficiency":null,"mb_normal_cost":null,"mb_required_contribution":null,"mb_withdrawal_liability":null,"mb_zone_status":null,"net_cash_flow":-2298956000.0,"net_investment_result":44329772000.0,"net_pension_liability":null,"pbgc_covered_code":null,"pension_obligation_bond_proceeds":null,"period_end":"2024-06-30","period_end_is_estimated":false,"pvf_salaries":null,"pvfb_retiree":393914932690.0,"pvfb_total":771105738231.0,"pvfc_total":null,"pvfnc_total":120444053239.0,"refunds_and_withdrawals":366423000.0,"required_contribution":null,"required_contribution_is_estimated":null,"sb_adjusted_ftap":null,"sb_assets_actuarial":null,"sb_assets_market":null,"sb_benefit_restriction_status":null,"sb_carryover_balance_boy":null,"sb_employee_contributions":null,"sb_employer_contributions":null,"sb_ftap":null,"sb_funding_target":null,"sb_funding_target_active_vested":null,"sb_funding_target_retired":null,"sb_funding_target_term_vested":null,"sb_minimum_required_contribution":null,"sb_prefunding_balance_boy":null,"sb_unpaid_minimum_all_years":null,"sch_h_actuarial_fees":null,"sch_h_admin_expenses":null,"sch_h_audit_fees":null,"sch_h_audit_opinion_code":null,"sch_h_benefit_payments":null,"sch_h_custodial_fees":null,"sch_h_employee_contributions":null,"sch_h_employer_contributions":null,"sch_h_investment_mgmt_fees":null,"sch_h_is_limited_scope_audit":null,"sch_h_legal_fees":null,"sch_h_net_assets":null,"sch_h_net_income":null,"sch_h_total_assets":null,"sch_h_total_assets_boy":null,"sch_h_total_contributions":null,"sch_h_total_income":null,"sch_h_total_liabilities":null,"sch_h_transfers_from":null,"sch_h_transfers_to":null,"sch_i_admin_expenses":null,"sch_i_audit_waived":null,"sch_i_benefit_payments":null,"sch_i_employee_contributions":null,"sch_i_employer_contributions":null,"sch_i_net_assets":null,"sch_i_net_assets_boy":null,"sch_i_net_income":null,"sch_i_total_assets":null,"sch_i_total_expenses":null,"sch_i_total_income":null,"sch_i_total_liabilities":null,"sch_i_transfers":null,"securities_lending_net":81996000.0,"sf_admin_expenses":null,"sf_benefit_payments":null,"sf_db_funding_required":null,"sf_employer_contrib_paid":null,"sf_employer_contributions":null,"sf_funding_deficiency":null,"sf_net_assets":null,"sf_net_assets_boy":null,"sf_net_income":null,"sf_other_contributions":null,"sf_other_expenses":null,"sf_participant_contributions":null,"sf_required_contribution":null,"sf_total_assets":null,"sf_total_expenses":null,"sf_total_income":null,"sf_total_liabilities":null,"sf_transfers":null,"sf_unpaid_minimum_current_year":null,"total_assets":506622976000.0,"total_assets_boy":464578144000.0,"total_contributions":31262052000.0,"total_pension_liability":null,"unfunded_liability":186594848000.0}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/assumptions":{"get":{"tags":["pensions"],"summary":"Actuarial assumptions","operationId":"plan_assumptions_v1_pensions_plans__identifier__assumptions_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"employee_group_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Employee Group Id"}},{"name":"tier_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Tier Id"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"amortization_basis":"fixed","amortization_method":"level_percent","amortization_period":24,"asset_smoothing_period":null,"asset_valuation_method":null,"at_risk_indicator":null,"cost_method":"entry_age_normal","cost_method_code":"1","discount_rate":0.068,"effective_date":"2023-06-30","effective_date_is_estimated":false,"effective_interest_rate":null,"employee_group_id":0,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","expected_return":0.068,"fiscal_year":2025,"inflation_assumption":0.028,"is_blended_discount_rate":false,"mortality_table_code":null,"period_end":"2025-06-30","segment_rate_1":null,"segment_rate_2":null,"segment_rate_3":null,"tier_id":0,"valuation_interest_rate_post":null,"valuation_interest_rate_pre":null},{"amortization_basis":"fixed","amortization_method":"level_percent","amortization_period":28,"asset_smoothing_period":null,"asset_valuation_method":null,"at_risk_indicator":null,"cost_method":"entry_age_normal","cost_method_code":"1","discount_rate":0.069,"effective_date":"2022-06-30","effective_date_is_estimated":false,"effective_interest_rate":null,"employee_group_id":0,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","expected_return":0.075,"fiscal_year":2022,"inflation_assumption":0.025,"is_blended_discount_rate":true,"mortality_table_code":null,"period_end":"2022-06-30","segment_rate_1":null,"segment_rate_2":null,"segment_rate_3":null,"tier_id":0,"valuation_interest_rate_post":null,"valuation_interest_rate_pre":null}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/participants":{"get":{"tags":["pensions"],"summary":"Workforce demographics","operationId":"plan_participants_v1_pensions_plans__identifier__participants_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"active_participants":924062,"avg_active_age":null,"avg_active_salary":null,"avg_active_salary_is_estimated":false,"avg_active_tenure":null,"avg_beneficiary_age":null,"avg_benefit":39396.0,"avg_benefit_is_estimated":false,"avg_retirement_age":null,"beneficiaries":103559,"contributing_employers":null,"covered_payroll":null,"disability_retirees":null,"drop_members":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","fiscal_year":2025,"payees_total":789016,"period_end":"2025-06-30","period_end_is_estimated":false,"retired_participants":685457,"separated_nonvested":null,"separated_vested":null,"total_participants":2233774},{"active_participants":924062,"avg_active_age":null,"avg_active_salary":null,"avg_active_salary_is_estimated":false,"avg_active_tenure":null,"avg_beneficiary_age":null,"avg_benefit":39396.0,"avg_benefit_is_estimated":false,"avg_retirement_age":null,"beneficiaries":103559,"contributing_employers":null,"covered_payroll":null,"disability_retirees":null,"drop_members":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","fiscal_year":2024,"payees_total":789016,"period_end":"2024-06-30","period_end_is_estimated":false,"retired_participants":685457,"separated_nonvested":null,"separated_vested":null,"total_participants":2233774}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/allocations":{"get":{"tags":["pensions"],"summary":"PPD sleeve allocations (target vs actual)","operationId":"plan_allocations_v1_pensions_plans__identifier__allocations_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"allocation_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(actual|target)$"},{"type":"null"}],"title":"Allocation Type"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"allocation_type":"actual","alternatives_misc_ratio":0.0,"cash_ratio":0.01979,"commodities_ratio":0.0,"domestic_equity_ratio":0.0,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","equities_ratio":0.36664,"fiscal_year":2025,"fixed_income_ratio":0.28558,"has_leverage":true,"hedge_funds_ratio":0.00094,"international_equity_ratio":0.0,"leverage_ratio":0.061,"other_ratio":0.00094,"period_end":"2025-06-30","period_end_is_estimated":false,"private_equity_ratio":0.20264,"real_estate_ratio":0.12347,"total_ratio":1.0},{"allocation_type":"target","alternatives_misc_ratio":0.0,"cash_ratio":0.0,"commodities_ratio":0.0,"domestic_equity_ratio":0.0,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","equities_ratio":0.39223,"fiscal_year":2025,"fixed_income_ratio":0.28252,"has_leverage":true,"hedge_funds_ratio":0.0,"international_equity_ratio":0.0,"leverage_ratio":0.03,"other_ratio":0.0,"period_end":"2025-06-30","period_end_is_estimated":false,"private_equity_ratio":0.17961,"real_estate_ratio":0.14563,"total_ratio":0.99999}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/asset-categories":{"get":{"tags":["pensions"],"summary":"Schedule H line 1c book asset categories (ERISA)","operationId":"plan_asset_categories_v1_pensions_plans__identifier__asset_categories_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/performance":{"get":{"tags":["pensions"],"summary":"Realized returns + liability duration (PPD, time-weighted)","operationId":"plan_performance_v1_pensions_plans__identifier__performance_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"benchmark_return":9.9,"cash_return":0.065,"duration_assets":null,"duration_method_code":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","equity_return":0.168,"fiscal_year":2025,"fixed_income_return":0.065,"geometric_return_since_2001":0.06002,"hedge_funds_return":0.034,"liability_duration":null,"period_end":"2025-06-30","period_end_is_estimated":false,"private_equity_return":0.14035,"real_estate_return":0.028,"return_is_net":true,"total_return":0.116,"total_return_is_estimated":false},{"benchmark_return":10.5,"cash_return":0.088,"duration_assets":null,"duration_method_code":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","equity_return":0.175,"fiscal_year":2024,"fixed_income_return":0.037,"geometric_return_since_2001":0.05775,"hedge_funds_return":null,"liability_duration":null,"period_end":"2024-06-30","period_end_is_estimated":false,"private_equity_return":0.11828,"real_estate_return":-0.071,"return_is_net":true,"total_return":0.093,"total_return_is_estimated":false}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/return-horizons":{"get":{"tags":["pensions"],"summary":"Multi-horizon return series (geometric vs arithmetic kept apart)","operationId":"plan_return_horizons_v1_pensions_plans__identifier__return_horizons_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"return_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(geometric|arithmetic)$"},{"type":"null"}],"title":"Return Kind"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","horizon_years":3,"is_estimated":null,"period_end":"2025-06-30","return_kind":"arithmetic","return_value":0.089},{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","horizon_years":5,"is_estimated":null,"period_end":"2025-06-30","return_kind":"arithmetic","return_value":0.084}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/service-providers":{"get":{"tags":["pensions"],"summary":"Schedule C service providers (managers, fees, CRD bridge to /v1/advisers)","operationId":"plan_service_providers_v1_pensions_plans__identifier__service_providers_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"is_manager","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: investment managers only (Sch C codes 27/28/31)","title":"Is Manager"},"description":"true: investment managers only (Sch C codes 27/28/31)"},{"name":"min_fee_bps","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Fee Bps"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/pooled-vehicles":{"get":{"tags":["pensions"],"summary":"Schedule D pooled-vehicle interests (the look-through)","operationId":"plan_pooled_vehicles_v1_pensions_plans__identifier__pooled_vehicles_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/insurance-contracts":{"get":{"tags":["pensions"],"summary":"Schedule A insurance contracts + pension-risk-transfer markers","operationId":"plan_insurance_contracts_v1_pensions_plans__identifier__insurance_contracts_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"prt_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: terminated-plan distribution (PRT) contracts only","title":"Prt Only"},"description":"true: terminated-plan distribution (PRT) contracts only"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":0,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/plans/{identifier}/metrics":{"get":{"tags":["pensions"],"summary":"Derived metrics — basis-stamped funding health, discipline, screens","operationId":"plan_metrics_v1_pensions_plans__identifier__metrics_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"actuary_changed":false,"admin_expense_ratio":0.0006459513798504109,"auditor_changed":false,"benefit_restriction_status":null,"consultant_changed":false,"contribution_basis":null,"contribution_vs_required_ratio":null,"credit_balance_to_minimum_ratio":null,"credit_balances_boy":null,"distress_tier":"fragile","entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","erisa_total_expense_ratio":null,"fiscal_year":2025,"funded_ratio":0.71313,"funded_ratio_basis":"gasb25","funded_ratio_change":0.0,"funded_ratio_prev":0.71313,"insurance_contract_count":null,"investment_expense_ratio":0.003320805216553817,"liability":650446656000.0,"liability_basis":"gasb25_aal","liability_maturity_basis":"ppd_pvfb","liability_maturity_ratio":0.5108442502239492,"look_through_required":null,"net_cash_flow_ratio":-0.009123113155157105,"period_end":"2025-06-30","plan_type":"public_db","pob_flagged_change":false,"pooled_exposure_ratio":null,"prt_event":null,"statutory_contribution_gap_rate":null,"total_assets":562975808000.0,"total_assets_basis":"ppd_market","universe":"public_ppd","withdrawal_liability":null,"withdrawal_liability_per_employer":null,"zone_status":null},{"actuary_changed":false,"admin_expense_ratio":0.0007479743674317684,"auditor_changed":false,"benefit_restriction_status":null,"consultant_changed":false,"contribution_basis":null,"contribution_vs_required_ratio":null,"credit_balance_to_minimum_ratio":null,"credit_balances_boy":null,"distress_tier":"fragile","entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","erisa_total_expense_ratio":null,"fiscal_year":2024,"funded_ratio":0.71313,"funded_ratio_basis":"gasb25","funded_ratio_change":0.0,"funded_ratio_prev":0.71313,"insurance_contract_count":null,"investment_expense_ratio":0.003248897262803967,"liability":650446656000.0,"liability_basis":"gasb25_aal","liability_maturity_basis":"ppd_pvfb","liability_maturity_ratio":0.5108442502239492,"look_through_required":null,"net_cash_flow_ratio":-0.004537804459938272,"period_end":"2024-06-30","plan_type":"public_db","pob_flagged_change":false,"pooled_exposure_ratio":null,"prt_event":null,"statutory_contribution_gap_rate":null,"total_assets":506622976000.0,"total_assets_basis":"ppd_market","universe":"public_ppd","withdrawal_liability":null,"withdrawal_liability_per_employer":null,"zone_status":null}],"meta":{"identifier":{"requested":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","resolved":{"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","matched_as":"entity_uuid","plan_name":"California PERF","universe":"public_ppd"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/systems":{"get":{"tags":["pensions"],"summary":"Retirement-system directory","operationId":"search_systems_v1_pensions_systems_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"description":"System-name search","title":"Q"},"description":"System-name search"},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"State"}},{"name":"gov_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Gov Level"}},{"name":"has_13f","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: systems with a verified 13F-filing institution (holdings servable)","title":"Has 13F"},"description":"true: systems with a verified 13F-filing institution (holdings servable)"},{"name":"has_ppd_history","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: systems in the PPD panel (plan-grain history available)","title":"Has Ppd History"},"description":"true: systems in the PPD panel (plan-grain history available)"},{"name":"min_total_assets","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"title":"Min Total Assets"}},{"name":"ids","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated entity_uuids (batch fetch, max 100)","title":"Ids"},"description":"Comma-separated entity_uuids (batch fetch, max 100)"},{"name":"sort","in":"query","required":false,"schema":{"type":"string","description":"total_assets|funded_ratio|total_participants|system_name","default":"total_assets","title":"Sort"},"description":"total_assets|funded_ratio|total_participants|system_name"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"census_unit_id":"226909","entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","financials_as_of_year":2024,"funded_ratio_basis":null,"funded_ratio_latest":null,"gov_level":"state","institution_cik":"0000919079","plan_count":4,"ppd_system_id":9,"state":"CA","system_name":"California Public Employees Retirement System","total_assets_basis":"aspp_cash_and_investments","total_assets_latest":552732549000,"total_participants_latest":2314437},{"census_unit_id":"226277","entity_uuid":"fd6d8851-aba5-e389-f03b-6aa9cb5d5cdd","financials_as_of_year":2024,"funded_ratio_basis":"gasb67","funded_ratio_latest":0.9388274090881231,"gov_level":"state","institution_cik":"0000810265","plan_count":2,"ppd_system_id":71,"state":"NY","system_name":"New York State and Local Retirement Systems","total_assets_basis":"gasb67_net_position","total_assets_latest":225972801000,"total_participants_latest":1159418}],"meta":{"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/systems/{identifier}":{"get":{"tags":["pensions"],"summary":"Retirement-system profile","operationId":"system_profile_v1_pensions_systems__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"active_participants_latest":957970,"aspp_first_year":2017,"aspp_last_year":2024,"beneficiaries_latest":804771,"census_unit_id":"226909","covered_payroll_latest":null,"discount_rate_latest":null,"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","financials_as_of_year":2024,"funded_ratio_basis":null,"funded_ratio_latest":null,"gov_level":"state","institution_cik":"0000919079","institution_entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","liability_latest":null,"money_weighted_return_latest":null,"plan_count":4,"ppd_data_end_year":2025,"ppd_data_start_year":2001,"ppd_system_id":9,"state":"CA","system_name":"California Public Employees Retirement System","total_assets_basis":"aspp_cash_and_investments","total_assets_latest":552732549000,"total_participants_latest":2314437,"unfunded_liability_latest":null},"meta":{"identifier":{"requested":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","resolved":{"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","matched_as":"entity_uuid","system_name":"California Public Employees Retirement System"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/systems/{identifier}/financials":{"get":{"tags":["pensions"],"summary":"ASPP system-grain series (survey years; weight-aware)","operationId":"system_financials_v1_pensions_systems__identifier__financials_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"from_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"From Year"}},{"name":"to_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"To Year"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"active_participants":957970,"actual_contributions":null,"actuarially_determined_contribution":null,"admin_expenses":378941000,"beneficiaries":804771,"benefit_payments":32815645000,"benefit_payments_gasb":null,"cash_and_short_term":21729231000,"covered_payroll":null,"discount_rate":null,"discount_rate_minus_1pct":null,"discount_rate_plus_1pct":null,"employee_contributions":6389252000,"employer_contributions":24726387325,"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","fiduciary_net_position":null,"final_weight":1,"funded_ratio":null,"interest_and_dividends":7517460000,"interest_cost":null,"investment_expenses":1647966000,"investment_income":7543213000,"long_term_investments":531003318000,"money_weighted_return":null,"net_pension_liability":null,"npl_at_discount_rate_minus_1pct":null,"npl_at_discount_rate_plus_1pct":null,"realized_unrealized_gain_loss":38440526000,"separated_nonvested":455284,"separated_total":551696,"separated_vested":96412,"service_cost":null,"survey_year":2024,"total_cash_and_investments":552732549000,"total_participants":2314437,"total_pension_liability":null,"total_pension_liability_boy":null,"withdrawals":366423000},{"active_participants":505719,"actual_contributions":null,"actuarially_determined_contribution":null,"admin_expenses":236679000,"beneficiaries":490486,"benefit_payments":23034362000,"benefit_payments_gasb":23253510000,"cash_and_short_term":1542859000,"covered_payroll":null,"discount_rate":null,"discount_rate_minus_1pct":null,"discount_rate_plus_1pct":null,"employee_contributions":3880584000,"employer_contributions":18147073000,"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","fiduciary_net_position":null,"final_weight":1,"funded_ratio":null,"interest_and_dividends":5565144000,"interest_cost":null,"investment_expenses":986975000,"investment_income":5632028000,"long_term_investments":341461671000,"money_weighted_return":null,"net_pension_liability":null,"npl_at_discount_rate_minus_1pct":null,"npl_at_discount_rate_plus_1pct":null,"realized_unrealized_gain_loss":20782650000,"separated_nonvested":0,"separated_total":241788,"separated_vested":241788,"service_cost":null,"survey_year":2023,"total_cash_and_investments":343004530000,"total_participants":1237993,"total_pension_liability":null,"total_pension_liability_boy":null,"withdrawals":219148000}],"meta":{"identifier":{"requested":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","resolved":{"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","matched_as":"entity_uuid","system_name":"California Public Employees Retirement System"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/systems/{identifier}/plans":{"get":{"tags":["pensions"],"summary":"Member plans (system → plan traversal)","operationId":"system_plans_v1_pensions_systems__identifier__plans_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"distress_tier_latest":"fragile","ein":null,"entity_uuid":"b375c3fb-2e29-46e6-bc61-ecf71ba577be","financials_as_of":"2025-06-30","funded_ratio_basis":"gasb25","funded_ratio_latest":0.71313,"plan_name":"California PERF","plan_number":null,"plan_status":"active","plan_type":"public_db","ppd_id":9,"sponsor_name":"California","sponsor_ticker":null,"state":"CA","system_entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","total_assets_basis":"ppd_market","total_assets_latest":562975808000.0,"total_participants_latest":2233774,"unfunded_liability_latest":186594848000.0,"universe":"public_ppd","zone_status":null}],"meta":{"identifier":{"requested":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","resolved":{"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","matched_as":"entity_uuid","system_name":"California Public Employees Retirement System"}},"pagination":{"count":1,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pensions/systems/{identifier}/holdings":{"get":{"tags":["pensions"],"summary":"The system's 13F portfolio (funding status → observable holdings)","operationId":"system_holdings_v1_pensions_systems__identifier__holdings_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":40,"title":"Identifier"}},{"name":"period_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"13F quarter end; defaults to the system's latest filed quarter","title":"Period End"},"description":"13F quarter end; defaults to the system's latest filed quarter"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"accession_number":"0000919079-26-000011","filing_date":"2026-08-14","investment_discretion":"sole","issuer_cik":"0000036405","issuer_name":"Vanguard S&P 500 ETF","market_value_usd":21094660362,"period_end":"2026-06-30","put_call":null,"security_type":"etf","security_uuid":"984206d6-541c-48c0-baef-6c440fc0056c","shares":30713968,"symbol":"VOO","title_of_class":"S&P 500 ETF SHS","voting_authority_none":0,"voting_authority_shared":0,"voting_authority_sole":30713968},{"accession_number":"0000919079-26-000011","filing_date":"2026-08-14","investment_discretion":"sole","issuer_cik":"0001100663","issuer_name":"iShares Core S&P 500 ETF","market_value_usd":11367659677,"period_end":"2026-06-30","put_call":null,"security_type":"etf","security_uuid":"f9f18faf-1a31-4407-8a75-9a517d134059","shares":15179345,"symbol":"IVV","title_of_class":"CORE S&P500 ETF","voting_authority_none":0,"voting_authority_shared":0,"voting_authority_sole":15179345}],"meta":{"identifier":{"requested":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","resolved":{"entity_uuid":"e32d8be3-3c6f-41a9-ea15-fb60ca4ed132","matched_as":"entity_uuid","system_name":"California Public Employees Retirement System"}},"institution_cik":"0000919079","pagination":{"count":2,"limit":5,"offset":0},"period_end":"2026-06-30"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ipos":{"get":{"tags":["ipos"],"summary":"IPOs (filterable)","operationId":"list_ipos_v1_ipos_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"filed|expected|priced|listed|withdrawn|postponed","title":"Status"},"description":"filed|expected|priced|listed|withdrawn|postponed"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"ipo_list_date lower bound","title":"From"},"description":"ipo_list_date lower bound"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"is_spac","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Filter SPAC offerings in or out","title":"Is Spac"},"description":"Filter SPAC offerings in or out"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":50000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"announced_date":"2026-09-18","company_name":"Retension Pharmaceuticals, Inc.","country_code":"US","listing_country_code":"US","currency_code":"USD","current_price":"12.2100","day1_close":"10.5300","day1_return":"-0.12250000000000000000","days_since_ipo":8,"entity_uuid":"e4aa68a1-d190-4d46-af0f-c10ba3e45b02","expected_list_date":null,"final_issue_price":"12.0000","first_filed_date":"2026-10-05","highest_offer_price":"13.0000","ipo_list_date":"2026-10-09","ipo_status":"listed","is_direct_listing":false,"is_spac":false,"is_upcoming":false,"is_validated":true,"lockup_days":180,"lockup_expiry_date":"2027-04-07","lowest_offer_price":"11.0000","max_drawdown_90d":"0E-20","max_shares_offered":3750000,"min_shares_offered":null,"offering_anchor_date":"2026-10-05","priced_date":"2026-10-09","priced_vs_range":"WITHIN","primary_mic":"XNAS","return_1y":"0.01749999999999996125","return_30d":"0.01749999999999996125","return_7d":"0.01749999999999996125","return_90d":"0.01749999999999996125","sector":"Healthcare","security_type":"COMMON_STOCK","security_uuid":"e6319081-b122-4552-8e11-0896364a4823","shares_outstanding":4581599,"sic":"2834","symbol":"RTSN","total_offer_size":"45000000.00","total_return":"0.01749999999999996125","underwriters":["Oppenheimer","Guggenheim"],"volatility_30d":null,"withdrawal_date":null},{"announced_date":"2026-09-18","company_name":"Trex Bio Inc.","country_code":"US","listing_country_code":"US","currency_code":"USD","current_price":"14.1600","day1_close":"14.0000","day1_return":"0E-20","days_since_ipo":8,"entity_uuid":"fce6e8b3-ebbc-4fbc-a4a0-20ddc69ae05f","expected_list_date":null,"final_issue_price":"14.0000","first_filed_date":null,"highest_offer_price":"16.0000","ipo_list_date":"2026-10-09","ipo_status":"listed","is_direct_listing":false,"is_spac":false,"is_upcoming":false,"is_validated":false,"lockup_days":null,"lockup_expiry_date":null,"lowest_offer_price":"14.0000","max_drawdown_90d":"-0.03777619387027797577","max_shares_offered":8333334,"min_shares_offered":null,"offering_anchor_date":"2026-09-18","priced_date":null,"priced_vs_range":"WITHIN","primary_mic":"XNAS","return_1y":"0.011428571428571428570","return_30d":"0.011428571428571428570","return_7d":"0.011428571428571428570","return_90d":"0.011428571428571428570","sector":null,"security_type":"COMMON_STOCK","security_uuid":"b53483b8-e383-4572-9792-8ba9e5a9e934","shares_outstanding":27445682,"sic":null,"symbol":"TRXB","total_offer_size":"116666676.00","total_return":"0.011428571428571428570000","underwriters":null,"volatility_30d":null,"withdrawal_date":null}],"meta":{"pagination":{"count":2,"limit":2,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ipos/upcoming":{"get":{"tags":["ipos"],"summary":"Upcoming IPOs (filed / expected / priced pipeline)","operationId":"upcoming_v1_ipos_upcoming_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"announced_date":null,"company_name":"Interactive Strength, Inc.","country_code":"US","listing_country_code":"US","currency_code":"USD","current_price":null,"day1_close":null,"day1_return":null,"days_since_ipo":1268,"entity_uuid":"e254fe20-3656-4702-a36e-f0568d53abd0","expected_list_date":null,"final_issue_price":"8.5000","first_filed_date":"2023-01-17","highest_offer_price":null,"ipo_list_date":"2023-04-28","ipo_status":"priced","is_direct_listing":false,"is_spac":false,"is_upcoming":true,"is_validated":false,"lockup_days":540,"lockup_expiry_date":"2024-10-19","lowest_offer_price":null,"max_drawdown_90d":null,"max_shares_offered":6846970,"min_shares_offered":null,"offering_anchor_date":"2023-01-17","priced_date":"2025-02-20","priced_vs_range":null,"primary_mic":"XNAS","return_1y":null,"return_30d":null,"return_7d":null,"return_90d":null,"sector":"Technology","security_type":"COMMON_STOCK","security_uuid":"a3de74cf-4527-4eb0-b0c0-df68a6331d27","shares_outstanding":1402102,"sic":"3600","symbol":"A","total_offer_size":"6983909.00","total_return":null,"underwriters":["UBS"],"volatility_30d":null,"withdrawal_date":null},{"announced_date":null,"company_name":"WEBUY GLOBAL LTD","country_code":"KY","listing_country_code":"KY","currency_code":"USD","current_price":null,"day1_close":null,"day1_return":null,"days_since_ipo":1094,"entity_uuid":"0ce247f3-d86d-4eb4-98d2-a50a4547ddd8","expected_list_date":null,"final_issue_price":"3.6500","first_filed_date":"2023-05-03","highest_offer_price":null,"ipo_list_date":"2023-10-19","ipo_status":"priced","is_direct_listing":false,"is_spac":false,"is_upcoming":true,"is_validated":false,"lockup_days":90,"lockup_expiry_date":"2024-01-17","lowest_offer_price":null,"max_drawdown_90d":null,"max_shares_offered":null,"min_shares_offered":null,"offering_anchor_date":"2023-05-03","priced_date":"2025-07-31","priced_vs_range":null,"primary_mic":"XNAS","return_1y":null,"return_30d":null,"return_7d":null,"return_90d":null,"sector":"Consumer Discretionary","security_type":"COMMON_STOCK","security_uuid":"b775a4af-9fc2-4d54-91ec-948a80b8919d","shares_outstanding":null,"sic":"5900","symbol":"WBUY","total_offer_size":null,"total_return":null,"underwriters":["UBS"],"volatility_30d":null,"withdrawal_date":null}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ipos/{identifier}":{"get":{"tags":["ipos"],"summary":"IPO offering history for a company","operationId":"ipo_by_identifier_v1_ipos__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 country filter for ticker resolution (e.g. JP); also lets numeric local tickers auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 country filter for ticker resolution (e.g. JP); also lets numeric local tickers auto-detect as tickers."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"announced_date":"2025-04-01","company_name":"Circle Internet Group, Inc.","country_code":"US","listing_country_code":"US","currency_code":"USD","current_price":"86.9700","day1_close":"83.2300","day1_return":"1.6848387096774194","days_since_ipo":499,"entity_uuid":"b25051e7-514e-4a0a-9e76-137fdf8beb3d","expected_list_date":null,"final_issue_price":"31.0000","first_filed_date":"2025-04-01","highest_offer_price":"28.0000","ipo_list_date":"2025-06-05","ipo_status":"listed","is_direct_listing":false,"is_spac":false,"is_upcoming":false,"is_validated":true,"lockup_days":180,"lockup_expiry_date":"2025-12-02","lowest_offer_price":"27.0000","max_drawdown_90d":"-0.55035111026760296071","max_shares_offered":10000000,"min_shares_offered":null,"offering_anchor_date":"2025-04-01","priced_date":"2025-06-05","priced_vs_range":"ABOVE","primary_mic":"XNYS","return_1y":"1.5896774193548387096653","return_30d":"5.089354838709677391","return_7d":"2.436774193548387085","return_90d":"2.821290322580645166","sector":"Financials","security_type":"COMMON_STOCK","security_uuid":"2b88f796-be6a-4462-8471-6ea65b522de6","shares_outstanding":200550578,"sic":"6199","symbol":"CRCL","total_offer_size":"1300000000.00","total_return":"1.80548387096774187435","underwriters":["Citigroup","Deutsche Bank"],"volatility_30d":"2.03237044779111","withdrawal_date":null}],"meta":{"count":1,"identifier":{"requested":"CRCL","resolved":{"entity_uuid":"b25051e7-514e-4a0a-9e76-137fdf8beb3d","grain":"security","name":"Circle Internet Group, Inc.","primary_mic":"XNYS","security_uuid":"2b88f796-be6a-4462-8471-6ea65b522de6","symbol":"CRCL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dividends/calendar":{"get":{"tags":["dividends"],"summary":"Upcoming ex-dividend dates","operationId":"dividend_calendar_v1_dividends_calendar_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: today","title":"From"},"description":"Default: today"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: from + 30 days","title":"To"},"description":"Default: from + 30 days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"amount_per_share":1.73,"currency":"USD","declared_date":"2026-09-10","dividend_type":"regular","ex_dividend_date":"2026-10-15","frequency":"quarterly","is_upcoming":true,"issuer_country_code":"US","pay_date":"2026-11-16","record_date":"2026-10-15","security_type":"COMMON_STOCK","security_uuid":"ade7a127-7d21-4ede-8b4a-b8742e95b18b","symbol":"ABBV"},{"amount_per_share":0.63,"currency":"USD","declared_date":"2026-09-17","dividend_type":"regular","ex_dividend_date":"2026-10-15","frequency":"quarterly","is_upcoming":true,"issuer_country_code":"US","pay_date":"2026-11-16","record_date":"2026-10-15","security_type":"COMMON_STOCK","security_uuid":"e9dfdc31-fdb6-4717-8362-4716f4fdbd8c","symbol":"ABT"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dividends/{identifier}":{"get":{"tags":["dividends"],"summary":"Dividend history for a security","operationId":"dividend_history_v1_dividends__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Type"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"amount_per_share":0.27,"currency":"USD","declared_date":"2026-07-30","dividend_type":"regular","ex_dividend_date":"2026-08-10","frequency":"quarterly","is_upcoming":false,"issuer_country_code":"US","pay_date":"2026-08-13","record_date":"2026-08-10","security_type":"COMMON_STOCK","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"},{"amount_per_share":0.27,"currency":"USD","declared_date":"2026-04-30","dividend_type":"regular","ex_dividend_date":"2026-05-11","frequency":"quarterly","is_upcoming":false,"issuer_country_code":"US","pay_date":"2026-05-14","record_date":"2026-05-11","security_type":"COMMON_STOCK","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/dividends/{identifier}/metrics":{"get":{"tags":["dividends"],"summary":"Dividend metrics (yield, payout, growth)","operationId":"dividend_metrics_v1_dividends__identifier__metrics_get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":0},{"type":"null"}],"description":"0 = trailing twelve months","title":"Fiscal Year"},"description":"0 = trailing twelve months"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":40,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"annual_dividend":1.03,"avg_yield_5y":0.004969,"cash_flow_payout_ratio":0.138327,"dividend_coverage":7.2635,"dividend_yield":0.003792,"fcf_to_dividend_ratio":6.4047,"fiscal_year":2025,"free_cash_flow":98767000000.0,"growth_10y_cagr":null,"growth_3y_cagr":0.042154,"growth_5y_cagr":-0.17001,"growth_rate_yoy":0.040404,"payout_frequency":"quarterly","payout_ratio":0.135849,"total_dividends_paid":15421000000.0,"years_of_increases":4},{"annual_dividend":0.99,"avg_yield_5y":0.008264,"cash_flow_payout_ratio":0.128824,"dividend_coverage":6.1531,"dividend_yield":0.003975,"fcf_to_dividend_ratio":7.1424,"fiscal_year":2024,"free_cash_flow":108807000000.0,"growth_10y_cagr":null,"growth_3y_cagr":0.046019,"growth_5y_cagr":-0.20099,"growth_rate_yoy":0.042105,"payout_frequency":"quarterly","payout_ratio":0.159657,"total_dividends_paid":15234000000.0,"years_of_increases":3}],"meta":{"count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"note":"fiscal_year 0 = trailing twelve months"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earnings/releases":{"get":{"tags":["earnings"],"summary":"Earnings releases by report date","description":"Every period whose results were RELEASED in the window (report_date =\nthe earnings-release / filing date). Only filing-dated rows appear here;\nstatement-only periods without a release date are reachable per company.","operationId":"earnings_releases_v1_earnings_releases_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: today − 7 days","title":"From"},"description":"Default: today − 7 days"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: today","title":"To"},"description":"Default: today"},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(quarterly|annual|all)$","description":"quarterly = Q1-Q4 rows, annual = FY rows, all = both","default":"all","title":"Period"},"description":"quarterly = Q1-Q4 rows, annual = FY rows, all = both"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"ISO-2 issuer country filter","title":"Country Code"},"description":"ISO-2 issuer country filter"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/earnings/{identifier}":{"get":{"tags":["earnings"],"summary":"Earnings history for a company","description":"Entity-grain: share classes of one issuer (GOOG / GOOGL) return the\nsame series. Newest fiscal period first.","operationId":"earnings_history_v1_earnings__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"period","in":"query","required":false,"schema":{"type":"string","pattern":"^(quarterly|annual|all)$","description":"quarterly = Q1-Q4 rows, annual = FY rows, all = both","default":"all","title":"Period"},"description":"quarterly = Q1-Q4 rows, annual = FY rows, all = both"},{"name":"fiscal_year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1990},{"type":"null"}],"title":"Fiscal Year"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"period_end >= from","title":"From"},"description":"period_end >= from"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"period_end <= to","title":"To"},"description":"period_end <= to"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/splits/calendar":{"get":{"tags":["splits"],"summary":"Upcoming stock splits","operationId":"split_calendar_v1_splits_calendar_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: today","title":"From"},"description":"Default: today"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Default: from + 30 days","title":"To"},"description":"Default: from + 30 days"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"description":"1-for-60 reverse split","effective_date":"2026-10-19","is_upcoming":true,"ratio":0.016667,"security_uuid":"a92d91da-5b39-4c28-88e1-b9a3b6df703e","split_from":60,"split_to":1,"split_type":"reverse","symbol":"AMTD"},{"description":"1-for-20 reverse split","effective_date":"2026-10-23","is_upcoming":true,"ratio":0.05,"security_uuid":"daa28640-eeec-4bd8-89df-61975d75483d","split_from":20,"split_to":1,"split_type":"reverse","symbol":"HCAI"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/splits/{identifier}":{"get":{"tags":["splits"],"summary":"Split history for a security","operationId":"split_history_v1_splits__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"description":"forward|reverse","title":"Type"},"description":"forward|reverse"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"description":"4-for-1 split","effective_date":"2020-08-31","is_upcoming":false,"ratio":4,"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","split_from":1,"split_to":4,"split_type":"forward","symbol":"AAPL"},{"description":"7-for-1 split","effective_date":"2014-06-09","is_upcoming":false,"ratio":7,"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","split_from":1,"split_to":7,"split_type":"forward","symbol":"AAPL"}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"limit":5,"offset":0}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/news":{"get":{"tags":["news"],"summary":"News feed (metadata only)","operationId":"news_feed_v1_news_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Category"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Topic"}},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Region"}},{"name":"publisher","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Publisher"}},{"name":"published_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Since"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"article_url":"https://www.globenewswire.com/news-release/2026/10/01/3373257/0/en/davis-commodities-limited-provides-update-on-otc-markets-quotation-status.html","author":null,"category":"commodities_energy","description":"SINGAPORE, Oct. 01, 2026 (GLOBE NEWSWIRE) -- Davis Commodities Limited (“Davis Commodities” or the “Company”) (OTC: DTCKF), an agricultural commodity trading company specializing in sugar, rice, and oil and fat products, today provided an update regarding the quotation of its Cla…","id":"6fb0e70d-11d3-4ca8-853a-406b184f06f1","image_url":null,"instruments":[{"asset_class":"equity","instrument_uuid":"2242e284-319d-4b1f-bcc9-2a79a581d417","is_primary":false,"name":"DAVIS COMMODITIES Ltd","relevance_score":0.5,"symbol":"DTCKF"},{"asset_class":"commodity","instrument_uuid":"0de2400a-30cf-474a-951c-d86479c4413b","is_primary":false,"name":"RICE","relevance_score":0.4,"symbol":"ZR"}],"language":"en","published_utc":"2026-10-01T16:29:00","publisher_name":"GlobeNewswire","region":"US","regions":["Asia","US"],"sentiment_label":"neutral","sentiment_score":0.0,"title":"Davis Commodities Limited Provides Update on OTC Markets Quotation Status","topics":null},{"article_url":"https://www.prnewswire.com/news-releases/open-letter-yes-ai-requires-independent-oversight-but-we-have-to-design-it-right-302896281.html","author":null,"category":"companies_earnings","description":"To the leaders building artificial intelligence (and the policymakers now responsible for governing it): WASHINGTON, Oct. 1, 2026 /PRNewswire/ -- For years, those of you building AI have told policymakers and the public, in increasingly concrete terms, that the companies building…","id":"0a38fac1-954a-46f2-89b9-2f4633ba00ce","image_url":"https://mmx.prnewswire.com/media/MS2000902/Oversight-Board-Logo.jpg?id=OA2982992&p=original","instruments":[],"language":"en","published_utc":"2026-10-01T16:27:00","publisher_name":"PR Newswire","region":"US","regions":["US"],"sentiment_label":"neutral","sentiment_score":0.0,"title":"Open Letter: Yes, AI Requires Independent Oversight, But We Have To Design It Right","topics":["Tech"]}],"meta":{"pagination":{"count":2,"next_cursor":"eyJ0IjoiMjAyNi0xMC0wMSAxNjoyNDo0NyIsImlkIjoiOTI0MzRlOTctNzk2ZS00MmVlLTk1NWEtOWM4NGEwMWViNDU4In0"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/news/security/{identifier}":{"get":{"tags":["news"],"summary":"News for a security (metadata only)","operationId":"security_news_v1_news_security__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"published_since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Since"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page size","default":25,"title":"Limit"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"article_url":"https://www.fool.com/investing/2026/09/30/meta-platforms-ai-hardware-history-says-apple/?source=iedfolrf0000001","author":"Neil Patel","category":"markets","description":"Unlike its hyperscaler peers, Meta Platforms (NASDAQ: META) doesn't operate its own legacy cloud computing platform. It's still investing heavily in artificial intelligence (AI), though, with capital expenditures forecast to be between $130 billion and $145 billion in 2026. The b…","id":"851aea6d-fae8-4cb7-a564-bb6d40f9e873","image_url":null,"instruments":[{"asset_class":"equity","instrument_uuid":"763376b2-3bfa-4d54-a636-85d4a99da5fe","is_primary":true,"name":"Meta Platforms, Inc.","relevance_score":1.0,"symbol":"META"},{"asset_class":"equity","instrument_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","is_primary":false,"name":"Apple Inc.","relevance_score":0.1,"symbol":"AAPL"}],"is_primary":false,"language":"en","mention_count":1,"published_utc":"2026-09-30T18:50:00","publisher_name":"Motley Fool","region":"US","regions":["US"],"relevance_score":0.1,"sentiment_label":"neutral","sentiment_score":0.0,"symbol":"AAPL","title":"Meta Platforms Is Making a Push Into AI Hardware. History Says Apple Investors Shouldn't Worry.","topics":["Tech","Energy"]},{"article_url":"https://www.fool.com/coverage/better-buy/2026/09/30/corning-vs-honeywell-international-which-technology-stock-is-a-better-buy-in-2026/?source=iedfolrf0000001","author":"Pamela Kock","category":"markets","description":"Investors often weigh the stability of an industrial giant against the growth potential of a specialized materials leader. Choosing between Corning (NYSE:GLW) and Honeywell International (NASDAQ:HON) requires balancing two very different business models. Corning provides the lite…","id":"615134cb-2f6f-4c59-80bd-856992bfaf5e","image_url":null,"instruments":[{"asset_class":"equity","instrument_uuid":"8dadea18-f23b-4b02-aa0a-9b1a6fd9af89","is_primary":true,"name":"HONEYWELL INTERNATIONAL INC","relevance_score":0.8,"symbol":"HON"},{"asset_class":"equity","instrument_uuid":"dad64291-408c-4b90-b1bd-3729d7211fe5","is_primary":false,"name":"CORNING INC","relevance_score":0.3,"symbol":"GLW"}],"is_primary":false,"language":"en","mention_count":1,"published_utc":"2026-09-30T15:31:28","publisher_name":"Motley Fool","region":"US","regions":["US"],"relevance_score":0.1,"sentiment_label":"neutral","sentiment_score":0.0,"symbol":"AAPL","title":"Corning vs. Honeywell International: Which Technology Stock Is a Better Buy in 2026?","topics":["Energy"]}],"meta":{"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}},"pagination":{"count":2,"next_cursor":"eyJ0IjoiMjAyNi0wOS0zMCAxMjo0NTowMCIsImlkIjoiYzA5MDVjZDMtZjY2ZS00OWQzLTk4NTQtMzNlNWJkMDY5MTY5In0"}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/news/{article_id}":{"get":{"tags":["news"],"summary":"Single article (metadata only)","operationId":"article_v1_news__article_id__get","parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"string","maxLength":64,"title":"Article Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"article_url":"https://www.globenewswire.com/news-release/2026/10/01/3373257/0/en/davis-commodities-limited-provides-update-on-otc-markets-quotation-status.html","author":null,"category":"commodities_energy","description":"SINGAPORE, Oct. 01, 2026 (GLOBE NEWSWIRE) -- Davis Commodities Limited (“Davis Commodities” or the “Company”) (OTC: DTCKF), an agricultural commodity trading company specializing in sugar, rice, and oil and fat products, today provided an update regarding the quotation of its Cla…","id":"6fb0e70d-11d3-4ca8-853a-406b184f06f1","image_url":null,"instruments":[{"asset_class":"equity","instrument_uuid":"2242e284-319d-4b1f-bcc9-2a79a581d417","is_primary":false,"name":"DAVIS COMMODITIES Ltd","relevance_score":0.5,"symbol":"DTCKF"},{"asset_class":"commodity","instrument_uuid":"0de2400a-30cf-474a-951c-d86479c4413b","is_primary":false,"name":"RICE","relevance_score":0.4,"symbol":"ZR"}],"keywords":"Nasdaq:DTCK,Other OTC:DTCKF,KYG2677P1054,KYG2677P1138,Stock Market News,Changes in company's own shares","language":"en","published_utc":"2026-10-01T16:29:00","publisher_name":"GlobeNewswire","region":"US","regions":["Asia","US"],"sentiment_label":"neutral","sentiment_score":0.0,"title":"Davis Commodities Limited Provides Update on OTC Markets Quotation Status","topics":null},"meta":{}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/short-volume/{identifier}":{"get":{"tags":["short-volume"],"summary":"Daily short volume (consolidated across FINRA facilities)","operationId":"short_volume_v1_short_volume__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)","title":"Identifier Type"},"description":"ticker|isin|cik|lei|figi|security_uuid (auto-detected when omitted)"},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers.","title":"Country Code"},"description":"Optional ISO-2 listing-country filter for ticker resolution (e.g. JP); also lets numeric local tickers (6758) auto-detect as tickers."},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"facility","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2},{"type":"null"}],"description":"Filter to days whose reporting-facility set includes this code: B = Cboe TRF, N = NYSE TRF, Q = Nasdaq TRF (authoritative list: /v1/catalog/finra-facilities)","title":"Facility"},"description":"Filter to days whose reporting-facility set includes this code: B = Cboe TRF, N = NYSE TRF, Q = Nasdaq TRF (authoritative list: /v1/catalog/finra-facilities)"},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":5000,"minimum":1},{"type":"null"}],"description":"Max rows (default 25 for JSON, full window for csv)","title":"Limit"},"description":"Max rows (default 25 for JSON, full window for csv)"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"csv for a per-security flat-file download (attribution embedded)","title":"Format"},"description":"csv for a per-security flat-file download (attribution embedded)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"facilities":["B","Q"],"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","short_exempt_volume":32668,"short_volume":8401576,"short_volume_ratio":0.5458851586008963,"total_volume":15390739,"trade_date":"2026-10-13"},{"facilities":["B","Q"],"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","short_exempt_volume":27794,"short_volume":5071601,"short_volume_ratio":0.527937612684824,"total_volume":9606440,"trade_date":"2026-10-12"}],"meta":{"attribution":"Source: FINRA, the owner and source of this data. Redistribution is not permitted.","count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/short-interest/{identifier}":{"get":{"tags":["short-interest"],"summary":"Short-interest history for a ticker","operationId":"by_ticker_v1_short_interest__identifier__get","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"identifier_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identifier Type"}},{"name":"country_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country Code"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":5000,"minimum":1},{"type":"null"}],"description":"Max rows (default 100 for JSON, full window for csv)","title":"Limit"},"description":"Max rows (default 100 for JSON, full window for csv)"},{"name":"format","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"csv for a per-security flat-file download (attribution embedded)","title":"Format"},"description":"csv for a per-security flat-file download (attribution embedded)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"avg_daily_volume":39858260,"change_percent":-6.21,"change_shares":-7989553,"current_short_shares":120763539,"days_to_cover":3.03,"exchange":"NASDAQ","mic":"XNAS","name":"Apple Inc.","previous_short_shares":128753092,"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","settlement_date":"2026-09-30","symbol":"AAPL"},{"avg_daily_volume":45135477,"change_percent":-7.87,"change_shares":-10996005,"current_short_shares":128753092,"days_to_cover":2.85,"exchange":"NASDAQ","mic":"XNAS","name":"Apple Inc.","previous_short_shares":139749097,"security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","settlement_date":"2026-09-15","symbol":"AAPL"}],"meta":{"attribution":"Source: FINRA, the owner and source of this data. Redistribution is not permitted.","count":2,"identifier":{"requested":"AAPL","resolved":{"entity_uuid":"e078582b-80f6-4e58-b1fb-2736b00b2b2b","grain":"security","name":"Apple Inc.","primary_mic":"XNAS","security_uuid":"f9ebb6c0-270b-4563-a713-d819b8ad943a","symbol":"AAPL"}}}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx":{"get":{"tags":["fx"],"summary":"FX reference rates — latest cross-section","operationId":"fx_cross_section_v1_fx_get","parameters":[{"name":"base","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":3,"maxLength":3},{"type":"null"}],"description":"Base currency, e.g. EUR","title":"Base"},"description":"Base currency, e.g. EUR"},{"name":"pair_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(major|minor|exotic)$"},{"type":"null"}],"title":"Pair Class"}},{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Specific reference date (default: latest)","title":"Date"},"description":"Specific reference date (default: latest)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":1000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"base_currency":"AUD","date":"2026-10-14","pair":"AUD/BRL","pair_class":"exotic","pair_name":"Australian Dollar / Brazilian Real","price_currency":"BRL","rate":3.52176},{"base_currency":"AUD","date":"2026-10-14","pair":"AUD/CAD","pair_class":"minor","pair_name":"Australian Dollar / Canadian Dollar","price_currency":"CAD","rate":0.996681}],"meta":{"count":2,"note":"ECB euro reference rates (daily, ~16:00 CET) — indicative reference/midpoint, not tradeable quotes.","source":"European Central Bank"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/fx/{base}/{quote}":{"get":{"tags":["fx"],"summary":"FX reference rate history for a pair","operationId":"fx_pair_v1_fx__base___quote__get","parameters":[{"name":"base","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":3,"title":"Base"}},{"name":"quote","in":"path","required":true,"schema":{"type":"string","minLength":3,"maxLength":3,"title":"Quote"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":8000,"minimum":1,"default":250,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"base_currency":"EUR","date":"2026-10-14","pair":"EUR/USD","pair_class":"major","pair_name":"Euro / US Dollar","price_currency":"USD","rate":1.1195},{"base_currency":"EUR","date":"2026-10-13","pair":"EUR/USD","pair_class":"major","pair_name":"Euro / US Dollar","price_currency":"USD","rate":1.1188}],"meta":{"count":2,"note":"ECB euro reference rates (daily, ~16:00 CET) — indicative reference/midpoint, not tradeable quotes.","source":"European Central Bank"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files":{"get":{"tags":["files"],"summary":"List export files","operationId":"list_files_v1_files_get","parameters":[{"name":"prefix","in":"query","required":false,"schema":{"type":"string","maxLength":200,"description":"Key prefix, e.g. v1/insider-transactions/daily/2026/07/","default":"v1/","title":"Prefix"},"description":"Key prefix, e.g. v1/insider-transactions/daily/2026/07/"},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"bytes":738,"key":"v1/central-bank-rates/manifest.json","last_modified":"2026-10-14T23:50:36.822000+00:00"},{"bytes":98764,"key":"v1/central-bank-rates/snapshots/2026-09-27-full.csv.gz","last_modified":"2026-09-27T07:43:22.924000+00:00"}],"meta":{"pagination":{"count":2,"next_cursor":"1-JTdCJTIydiUyMiUzQTElMkMlMjJzdGFydEFmdGVyJTIyJTNBJTIydjElMkZjZW50cmFsLWJhbmstcmF0ZXMlMkZzbmFwc2hvdHMlMkYyMDI2LTEwLTE0LWZ1bGwuY3N2Lmd6JTIyJTJDJTIydXVpZCUyMiUzQSUyMjdlNWVjMzJjY2YyMzEyMTQ1ZGZiODQyMjA1MTc4ZjRiJTIyJTdE"},"prefix":"v1/"}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/files/{path}":{"get":{"tags":["files"],"summary":"Download a file (302 to a presigned URL)","operationId":"download_file_v1_files__path__get","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/financial-metrics":{"get":{"tags":["catalog"],"summary":"Standardized financial statement metrics","operationId":"financial_metrics_v1_catalog_financial_metrics_get","parameters":[{"name":"statement","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(income_statement|balance_sheet|cash_flow)$"},{"type":"null"}],"title":"Statement"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"data_type":"monetary","display_name":"Accounts Receivable","is_calculated":false,"line_item_category":"current_assets","metric_name":"accounts_receivable","statement_type":"balance_sheet"},{"data_type":"monetary","display_name":"Cash and Cash Equivalents","is_calculated":false,"line_item_category":"current_assets","metric_name":"cash_and_equivalents","statement_type":"balance_sheet"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/ratios":{"get":{"tags":["catalog"],"summary":"Available ratios grouped by category","operationId":"ratio_catalog_v1_catalog_ratios_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"cash_flow":["cash_flow_to_revenue","cash_return_on_assets"],"efficiency":["cash_conversion_cycle","operating_cycle"],"liquidity":["current_ratio","quick_ratio"],"profitability":["gross_profit_margin","net_profit_margin"],"solvency":["debt_to_equity","long_term_debt_to_equity"],"ttm":["revenue_ttm","revenue_growth_yoy_ttm"],"valuation":["pe_ratio","pb_ratio"]},"meta":{}}}}}}}},"/v1/catalog/filing-forms":{"get":{"tags":["catalog"],"summary":"Corporate filing form codes and standardized types","operationId":"filing_forms_v1_catalog_filing_forms_get","parameters":[{"name":"source_system","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"EDGAR, ESEF, DART, EDINET, CVM, BSE or MOPS","title":"Source System"},"description":"EDGAR, ESEF, DART, EDINET, CVM, BSE or MOPS"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"form_code":"quarterly_results","form_label":"Quarterly results","form_type":"quarterly","is_amendment":false,"source_system":"BSE"},{"form_code":"AA01","form_label":"Change of accounting reference date","form_type":"administrative","is_amendment":false,"source_system":"COMPANIES_HOUSE"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/economic-indicators":{"get":{"tags":["catalog"],"summary":"Available economic indicator series","operationId":"economic_indicators_v1_catalog_economic_indicators_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Category"}},{"name":"concept","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"description":"Country-agnostic concept key (e.g. cpi_yoy) — lists every country carrying it","title":"Concept"},"description":"Country-agnostic concept key (e.g. cpi_yoy) — lists every country carrying it"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"growth","concept":"gdp_contrib_gfcf","country_code":"AT","currency":null,"description":"Contribution of gross fixed capital formation to quarterly real GDP growth, percentage points","first_date":"2010-01-01","frequency":"quarterly","indicator_code":"AT_GDP_CONTRIB_GFCF","indicator_name":"Austria GDP Contribution: Fixed Investment","latest_date":"2026-04-01","metric":"pp contribution (QoQ)","obs_count":66,"seasonal_adjustment":"seasonally_adjusted","subcategory":"Growth Contributions"},{"category":"growth","concept":"gdp_contrib_govt","country_code":"AT","currency":null,"description":"Contribution of government final consumption to quarterly real GDP growth, percentage points","first_date":"2010-01-01","frequency":"quarterly","indicator_code":"AT_GDP_CONTRIB_GOVT","indicator_name":"Austria GDP Contribution: Government Consumption","latest_date":"2026-04-01","metric":"pp contribution (QoQ)","obs_count":66,"seasonal_adjustment":"seasonally_adjusted","subcategory":"Growth Contributions"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/rate-series":{"get":{"tags":["catalog"],"summary":"Rates catalog — every servable series and spread","description":"The complete public rates vocabulary: government benchmark yields,\novernight reference rates, computed tenor-pair spreads, and curated\nspreads. Every ID listed here resolves in the rates endpoints, and the\nrates endpoints serve nothing that isn't listed here.","operationId":"rate_series_v1_catalog_rate_series_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"yield, overnight, or spread","title":"Type"},"description":"yield, overnight, or spread"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"description":"e.g. sovereign_yield, overnight, tenor_pair, credit, breakeven","title":"Category"},"description":"e.g. sovereign_yield, overnight, tenor_pair, credit, breakeven"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"overnight","country_code":"AU","currency":"AUD","description":"AUD Overnight Index Average (AONIA), AU overnight reference rate.","frequency":"daily","maturity_days":1,"maturity_label":"Overnight","series_id":"AONIA","series_name":"AUD Overnight Index Average","series_type":"overnight","term_years":null,"unit":"percent"},{"category":"breakeven","country_code":"AU","currency":null,"description":"Nominal minus indexed 10Y — Australian inflation expectations","frequency":null,"maturity_days":null,"maturity_label":null,"series_id":"AU_10Y_BREAKEVEN","series_name":"Australia 10Y Breakeven","series_type":"spread","term_years":null,"unit":"percent"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/vocabularies":{"get":{"tags":["catalog"],"summary":"All enum vocabularies used across the API","operationId":"vocabularies_v1_catalog_vocabularies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":{"asset-classes":[{"id":"commodities","label":"Commodities"},{"id":"digital_assets","label":"Digital Assets"}],"congress-asset-types":[{"id":"corporate_bond","label":"Corporate bond"},{"id":"etf","label":"ETF"}],"congress-owner-types":[{"id":"dependent_child","label":"Dependent child"},{"id":"joint","label":"Joint account"}],"econ-categories":[{"id":"business","label":"Business"},{"id":"credit","label":"Credit"}],"fund-asset-classes":[{"id":"ALTERNATIVE","label":"Alternative"},{"id":"COMMODITIES","label":"Commodities"}],"fund-service-provider-types":[{"id":"ADMINISTRATOR","label":"Administrator"},{"id":"AUTHORIZED_PARTICIPANT","label":"Authorized Participant"}],"fund-share-classes":[{"id":"1","label":"1"},{"id":"100","label":"100"}],"fund-structures":[{"id":"CLOSED_END","label":"Closed End"},{"id":"INSURANCE_SEPARATE_ACCOUNT","label":"Insurance Separate Account"}],"fund-sub-types":[{"id":"ETMF","label":"Etmf"},{"id":"FUND_OF_FUNDS","label":"Fund Of Funds"}],"fund-types":[{"id":"CLOSED_END_FUND","label":"Closed End Fund"},{"id":"ETF","label":"Etf"}],"instrument-types":[{"id":"annuity","label":"Annuity"},{"id":"bond","label":"Bond"}],"ipo-statuses":[{"id":"direct_listing","label":"Direct listing"},{"id":"expected","label":"Expected"}],"news-categories":[{"id":"commodities_energy","label":"Commodities & energy"},{"id":"companies_earnings","label":"Companies & earnings"}],"pension-allocation-types":[{"id":"actual","label":"Actual allocation"},{"id":"target","label":"Target allocation"}],"pension-benefit-restriction-statuses":[{"id":"none","label":"No restriction (AFTAP >= 80%)"},{"id":"restricted_80","label":"Restricted (AFTAP < 80%)"}],"pension-contribution-bases":[{"id":"ppd_reported","label":"PPD reported percent of required paid"},{"id":"sb_minimum","label":"Schedule SB contributions vs minimum"}],"pension-contribution-standards":[{"id":"arc","label":"Annual required contribution (pre-2014)"},{"id":"adec","label":"Actuarially determined employer contribution"}],"pension-distress-tiers":[{"id":"resilient","label":"Resilient (funded ratio >= 90%)"},{"id":"fragile","label":"Fragile (60-90%)"}],"pension-financial-regimes":[{"id":"gasb","label":"GASB 25/67 (PPD public plans)"},{"id":"sch_h","label":"Schedule H (ERISA large plans)"}],"pension-funded-ratio-bases":[{"id":"gasb25","label":"GASB 25 actuarial"},{"id":"gasb67","label":"GASB 67 market"}],"pension-gov-levels":[{"id":"county","label":"County"},{"id":"municipal","label":"Municipal"}],"pension-liability-bases":[{"id":"gasb25_aal","label":"GASB 25 actuarial accrued liability"},{"id":"gasb67_tpl","label":"GASB 67 total pension liability"}],"pension-liability-maturity-bases":[{"id":"sch_sb","label":"Schedule SB funding-target split"},{"id":"ppd_pvfb","label":"PPD present value of future benefits"}],"pension-plan-categories":[{"id":"1","label":"pers_ers"},{"id":"2","label":"trs"}],"pension-plan-statuses":[{"id":"active","label":"Active"},{"id":"closed","label":"Closed"}],"pension-plan-types":[{"id":"multiemployer","label":"Multiemployer"},{"id":"multiple_employer","label":"Multiple Employer"}],"pension-provider-types":[{"id":"Accounting (including auditing)","label":"Accounting (Including Auditing)"},{"id":"Actuarial","label":"Actuarial"}],"pension-return-kinds":[{"id":"geometric","label":"Geometric (compound) return"},{"id":"arithmetic","label":"Arithmetic average return"}],"pension-total-assets-bases":[{"id":"gasb67_net_position","label":"GASB 67 fiduciary net position"},{"id":"ppd_market","label":"PPD market assets"}],"pension-universes":[{"id":"erisa","label":"Erisa"},{"id":"public_ppd","label":"Public Ppd"}],"pension-vehicle-types":[{"id":"commingled_trust","label":"Commingled Trust"},{"id":"lp_103_12","label":"Lp 103 12"}],"pension-zone-statuses":[{"id":"green","label":"Green (neither endangered nor critical)"},{"id":"endangered","label":"Endangered (yellow)"}],"security-types":[{"id":"alternative_fund","label":"Alternative Fund"},{"id":"annuity","label":"Annuity"}],"venue-types":[{"id":"ats","label":"Ats"},{"id":"exchange","label":"Exchange"}]},"meta":{}}}}}}}},"/v1/catalog/pension-service-codes":{"get":{"tags":["catalog"],"summary":"Form 5500 Schedule C service and compensation codes","operationId":"pension_service_codes_v1_catalog_pension_service_codes_get","parameters":[{"name":"vocabulary","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(service|compensation)$"},{"type":"null"}],"description":"service = codes 10-49 (what was done), compensation = codes 50-99 (how it was paid)","title":"Vocabulary"},"description":"service = codes 10-49 (what was done), compensation = codes 50-99 (how it was paid)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"code":"10","is_investment_management":false,"label":"Accounting (including auditing)","vocabulary":"service"},{"code":"11","is_investment_management":false,"label":"Actuarial","vocabulary":"service"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/insider-transaction-codes":{"get":{"tags":["catalog"],"summary":"SEC Form 4 transaction codes with labels","operationId":"insider_transaction_codes_v1_catalog_insider_transaction_codes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"code":"A","label":"Grant, award or other acquisition"},{"code":"C","label":"Conversion of derivative security"}],"meta":{"count":2}}}}}}}},"/v1/catalog/finra-facilities":{"get":{"tags":["catalog"],"summary":"FINRA short-volume reporting facilities","operationId":"finra_facilities_v1_catalog_finra_facilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"code":"B","label":"FINRA/Cboe TRF (formerly BATS)"},{"code":"B,N","label":"FINRA/Cboe TRF + FINRA/NYSE TRF"}],"meta":{"count":2}}}}}}}},"/v1/catalog/fund-holding-asset-codes":{"get":{"tags":["catalog"],"summary":"N-PORT asset category codes","operationId":"fund_holding_asset_codes_v1_catalog_fund_holding_asset_codes_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"asset_class":"Fixed Income","code":"ABS-ABCP","description":"Asset-backed commercial paper","is_derivative":false,"name":"ABS - Asset-Backed Commercial Paper"},{"asset_class":"Fixed Income","code":"ABS-CBDO","description":"Collateralized bond obligations","is_derivative":false,"name":"ABS - Collateralized Bond Obligation"}],"meta":{"count":2}}}}}}}},"/v1/catalog/spreads":{"get":{"tags":["catalog"],"summary":"Available curated rate-spread definitions","description":"Curated spreads only — cross-country (e.g. BTP-Bund), credit and\nbreakeven definitions. Same-country tenor-pair spreads are served\ncomputed from /v1/rates/spreads with IDs like US_10Y_2Y (every pair,\nno catalog needed), so curve_shape definitions are excluded here to\navoid a second vocabulary for the same data.","operationId":"spreads_v1_catalog_spreads_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"breakeven","country_code":"AU","description":"Nominal minus indexed 10Y — Australian inflation expectations","leg_a_series_id":"AU_10Y_GOVT","leg_b_series_id":"AU_10Y_INDEXED","series_id":"AU_10Y_BREAKEVEN","series_name":"Australia 10Y Breakeven"},{"category":"breakeven","country_code":"BR","description":"Nominal LTN minus IPCA NTN-B — Brazilian inflation expectations","leg_a_series_id":"BR_10Y_GOVT","leg_b_series_id":"BR_10Y_IPCA","series_id":"BR_10Y_BREAKEVEN","series_name":"Brazil 10Y Breakeven"}],"meta":{"count":2}}}}}}}},"/v1/catalog/countries":{"get":{"tags":["catalog"],"summary":"Country legend — ISO-2 codes used across the API","description":"iso3_code/numeric_code are ISO 3166-1 (null for pseudo-entries like\nEU). currency is the ISO 4217 national currency (eurozone members\nresolve to EUR); it may name codes beyond /v1/catalog/currencies, which\nlists only currencies this API serves data for.","operationId":"countries_v1_catalog_countries_get","parameters":[{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(americas|europe|asia_pacific|middle_east|africa)$"},{"type":"null"}],"title":"Region"}},{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":3,"maxLength":3},{"type":"null"}],"description":"Filter to countries using this currency, e.g. EUR","title":"Currency"},"description":"Filter to countries using this currency, e.g. EUR"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"AL","country_name":"Albania","currency":"ALL","iso3_code":"ALB","numeric_code":null,"official_name":null,"region":"europe"},{"country_code":"AS","country_name":"American Samoa","currency":"USD","iso3_code":"ASM","numeric_code":null,"official_name":null,"region":"asia_pacific"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/catalog/currencies":{"get":{"tags":["catalog"],"summary":"Currency legend — ISO-3 codes used across the API","description":"Active currencies only. Servable FX pair coverage lives in\n/v1/catalog/fx-pairs.","operationId":"currencies_v1_catalog_currencies_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"country_code":"AE","currency":"AED","currency_name":"UAE Dirham"},{"country_code":"AU","currency":"AUD","currency_name":"Australian Dollar"}],"meta":{"count":2}}}}}}}},"/v1/catalog/fx-pairs":{"get":{"tags":["catalog"],"summary":"FX pair catalog — every servable /v1/fx pair","description":"The complete public FX vocabulary: every pair listed here resolves in\n/v1/fx/{base}/{quote}, and /v1/fx serves nothing that isn't listed here.\nfirst_date/latest_date/obs_count describe observation coverage.","operationId":"fx_pairs_v1_catalog_fx_pairs_get","parameters":[{"name":"currency","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":3,"maxLength":3},{"type":"null"}],"description":"Filter to pairs with this currency on either leg","title":"Currency"},"description":"Filter to pairs with this currency on either leg"},{"name":"pair_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(major|minor|exotic)$"},{"type":"null"}],"title":"Pair Class"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"base_currency":"AUD","first_date":"2008-01-02","latest_date":"2026-10-14","obs_count":4791,"pair":"AUD/BRL","pair_class":"exotic","pair_name":"Australian Dollar / Brazilian Real","price_currency":"BRL"},{"base_currency":"AUD","first_date":"2005-04-01","latest_date":"2026-10-14","obs_count":5496,"pair":"AUD/CNY","pair_class":"exotic","pair_name":"Australian Dollar / Yuan Renminbi","price_currency":"CNY"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calendar/economic":{"get":{"tags":["calendar"],"summary":"Economic calendar — data releases & central-bank meetings","description":"Default: upcoming events (today → +365d).","operationId":"economic_calendar_v1_calendar_economic_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"importance","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(high|medium|low)$"},{"type":"null"}],"title":"Importance"}},{"name":"event_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"description":"data_release, central_bank_meeting","title":"Event Type"},"description":"data_release, central_bank_meeting"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":250,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"category":"industrial","central_bank_id":null,"central_bank_name":null,"country_code":"JP","country_name":"Japan","date":"2026-10-15","datetime_utc":"2026-10-15 04:30:00+00:00","event_name":"Japan Industrial Production","event_type":"data_release","has_press_conference":false,"importance":"medium","time":"00:30:00"},{"category":"trade","central_bank_id":null,"central_bank_name":null,"country_code":"GB","country_name":"United Kingdom","date":"2026-10-15","datetime_utc":"2026-10-15 06:00:00+00:00","event_name":"UK Trade Balance","event_type":"data_release","has_press_conference":false,"importance":"medium","time":"02:00:00"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/calendar/market-holidays":{"get":{"tags":["calendar"],"summary":"Exchange market holidays","description":"Default: upcoming holidays (today → +365d). Keyed by operating MIC;\nuse /v1/exchanges to bridge from segment MICs.","operationId":"market_holidays_v1_calendar_market_holidays_get","parameters":[{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":2},{"type":"null"}],"title":"Country"}},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"description":"Operating MIC or acronym, e.g. XNYS, LSE","title":"Exchange"},"description":"Operating MIC or acronym, e.g. XNYS, LSE"},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":5000,"minimum":1,"default":250,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{},"example":{"data":[{"close_time":null,"country_code":"BR","country_name":"Brazil","date":"2026-11-02","exchange":"B3","exchange_name":"BRASIL BOLSA BALCAO","mic":"BVMF","name":"Dia dos Finados","open_time":null,"status":"closed"},{"close_time":null,"country_code":"JP","country_name":"Japan","date":"2026-11-03","exchange":"JPX","exchange_name":"JAPAN EXCHANGE GROUP","mic":"XJPX","name":"Culture Day","open_time":null,"status":"closed"}],"meta":{"count":2}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Authorization: Bearer sm_live_..."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"servers":[{"url":"https://api.shamburgmarkets.com"}],"security":[{"bearerAuth":[]},{"apiKeyHeader":[]}],"tags":[{"name":"reference","description":"Full-text search, security profiles, listings, and exchanges — the starting point for resolving anything."},{"name":"entities","description":"Issuer/filer profiles, corporate complexes, and subsidiary trees keyed by entity_uuid."},{"name":"filings","description":"Raw filing index across EDGAR, EDINET, DART, ESEF and more, with source-document links where redistributable."},{"name":"financials","description":"As-filed income statement, balance sheet, and cash-flow lines — annual, quarterly, and TTM — standardized metric names."},{"name":"ratios","description":"Derived valuation, profitability, leverage, and liquidity ratios, point-in-time and history."},{"name":"insiders","description":"SEC Form 3/4/5 insider transactions and current holdings; firehose with filed_since delta sync."},{"name":"congress","description":"Congressional stock trades from Senate and House periodic transaction reports. Free for any valid key (5 U.S.C. §13107(c))."},{"name":"funds","description":"Registered funds: profiles, classes, N-PORT holdings, flows, returns, managers — plus institutional 13F positions and reverse lookups."},{"name":"advisers","description":"SEC-registered investment advisers (Form ADV): AUM history, owners, private funds, disciplinary disclosures."},{"name":"pensions","description":"US pension universe: Form 5500 private plans and public retirement systems — financials, allocations, performance, service providers."},{"name":"economy","description":"Economic indicators and release calendars across FRED, OECD, Eurostat, ECB, BIS, and IMF sources."},{"name":"rates","description":"Sovereign yield curves, policy rates, overnight benchmarks, and spread series with full history."},{"name":"fx","description":"ECB reference FX rates — current matrix and pair history."},{"name":"calendar","description":"Economic release and market-holiday calendars."},{"name":"dividends","description":"Declared dividends, per-security dividend metrics, and the forward calendar."},{"name":"earnings","description":"Reported earnings per fiscal period: as-reported and split-adjusted EPS (GAAP and non-GAAP), revenue, release dates, and a releases-by-date feed."},{"name":"splits","description":"Stock splits — per security and calendar."},{"name":"ipos","description":"IPO offerings at (issuer, offering) grain: pipeline (filed/expected/priced), listings, withdrawals, pricing vs range, lockups, and Day-1 through 1-year aftermarket returns. symbol is the issuer's current security_master symbol."},{"name":"news","description":"Market news metadata with resolved instrument links and sentiment."},{"name":"short-interest","description":"FINRA consolidated short interest per security (?format=csv supported)."},{"name":"short-volume","description":"FINRA daily short-sale volume per security (?format=csv supported)."},{"name":"files","description":"Bulk flat-file exports: list and download gzipped CSVs (entitlement required)."},{"name":"catalog","description":"Machine-readable legends: vocabularies, countries, currencies, metric/ratio/series catalogs."}],"x-tagGroups":[{"name":"Reference & Filings","tags":["reference","entities","filings"]},{"name":"Fundamentals","tags":["financials","ratios"]},{"name":"Ownership & Funds","tags":["insiders","congress","funds","advisers","pensions"]},{"name":"Economy & Rates","tags":["economy","rates","fx","calendar"]},{"name":"Corporate Events","tags":["earnings","dividends","splits","ipos"]},{"name":"Markets & News","tags":["news","short-interest","short-volume"]},{"name":"Bulk Data & Discovery","tags":["files","catalog"]}]}