{"openapi":"3.1.0","info":{"title":"FilingDelta API","version":"2026-10-24","contact":{"email":"filingdelta@proton.me"},"description":"SEC filing diff and materiality signals for agents: what changed in the latest 10-Q or 10-K","x-guidance":"Start free: GET /catalog lists the covered tickers (AMD, MRVL, NVDA, AVGO, TSM, MU, AMAT, AAPL, MSFT, META, TSLA, ORCL, INTC, ASML, MSTR, JPM, BAC, GS, WFC, NFLX, JNJ, BRK, PLTR, SPCX), central-bank ids (BOE, FED, ECB, BOJ, RBA, BOC, SNB, NOR, SWE, MEX, BOK, TUR, IND, ZAF, CHN, IDN, ETH, RUS, EGY, IRN, BCB) and US macro ids (NFP, GDP, CPI). GET /sample/{ticker} and GET /sample/macro/{id} return a free, labelled, trimmed view of the paid card (the highest-materiality changes or the first items; the paid card has all of them; comparison_basis says how many); GET /sample/policy/{id} returns the previous meeting's card for that bank, free and labelled in summary (the paid card is the latest decision). Paid: GET /delta/{ticker} (SEC filing diff: what changed in the latest 10-Q or 10-K; e.g. /delta/AMD) and GET /policy/{id} (e.g. /policy/BOE), $0.01 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). GET /macro/{id} (e.g. /macro/NFP), $0.01 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Bundles (cheaper than the single cards): GET /bundle/SEMIS (AMD, MRVL, NVDA, AVGO, TSM, MU, AMAT, INTC, ASML) $0.12; GET /bundle/CENTRALBANKS (BOE, FED, ECB, BOJ, RBA, BOC, SNB) $0.08; GET /bundle/BRICS (BCB, IND, ZAF, CHN, RUS, IDN, ETH, EGY, IRN) $0.08. An unpaid call returns 402 with the PaymentRequired in the PAYMENT-REQUIRED header; retry with PAYMENT-SIGNATURE. Unknown tickers and ids return a free 404 before payment, with the valid ids and an example URL in the JSON body. Changelog: GET /updates. MCP: POST /mcp."},"servers":[{"url":"https://filingdelta.xyz"}],"paths":{"/delta/{ticker}":{"get":{"operationId":"getFilingDelta","summary":"SEC filing diff: what changed in the latest 10-Q or 10-K for one ticker","tags":["paid"],"description":"SEC filing diff for one ticker: what changed in the latest 10-Q or 10-K (6-K or 8-K for some filers), each change with a materiality rating, EDGAR citation and why it matters. $0.01 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Free trimmed sample (a labelled subset of this card, with its true counts): /sample/{ticker}.","parameters":[{"name":"ticker","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog filers.","schema":{"type":"string","enum":["AMD","MRVL","NVDA","AVGO","TSM","MU","AMAT","AAPL","MSFT","META","TSLA","ORCL","INTC","ASML","MSTR","JPM","BAC","GS","WFC","NFLX","JNJ","BRK","PLTR","SPCX"]},"example":"AMD"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingCard"}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown ticker (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_tickers":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_tickers","example"]}}}}}}},"/policy/{id}":{"get":{"operationId":"getPolicyCard","summary":"Central-bank decision card for one id","tags":["paid"],"description":"Central-bank interest rate decision card for one bank: hike, hold or cut, policy rate, change in bps, next decision date and official source. $0.02 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Free sample: the previous meeting's card for this bank, labelled in summary (the paid card is the latest decision): /sample/policy/{id}.","parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog policy.","schema":{"type":"string","enum":["BOE","FED","ECB","BOJ","RBA","BOC","SNB","NOR","SWE","MEX","BOK","TUR","IND","ZAF","CHN","IDN","ETH","RUS","EGY","IRN","BCB"]},"example":"BOE"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyCard"}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/sample/{ticker}":{"get":{"operationId":"getFilingSample","summary":"Free trimmed sample of the filing-change card (labelled in comparison_basis; the paid card has all changes)","tags":["free"],"security":[],"parameters":[{"name":"ticker","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog free_samples.","schema":{"type":"string","enum":["AMD","MRVL","NVDA","AVGO","TSM","MU","AMAT","AAPL","MSFT","META","TSLA","ORCL","INTC","ASML","MSTR","JPM","BAC","GS","WFC","NFLX","JNJ","BRK","PLTR","SPCX"]},"example":"AMD"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingCard"}}}},"404":{"description":"Unknown ticker (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_tickers":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_tickers","example"]}}}}}}},"/sample/policy/{id}":{"get":{"operationId":"getPolicySample","summary":"Free sample: previous-meeting central-bank card (labelled in summary; the paid card is the latest decision)","tags":["free"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog policy.","schema":{"type":"string","enum":["BOE","FED","ECB","BOJ","RBA","BOC","SNB","NOR","SWE","MEX","BOK","TUR","IND","ZAF","CHN","IDN","ETH","RUS","EGY","IRN","BCB"]},"example":"BOE"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyCard"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/macro/{id}":{"get":{"operationId":"getMacroCard","summary":"US macro release card for one id","tags":["paid"],"description":"US macro release card (CPI inflation, GDP growth or nonfarm payrolls) from the official BLS or BEA release, with verbatim quotes and the next release date. $0.01 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Free trimmed sample (a labelled subset of this card, with its true counts): /sample/macro/{id}.","parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog macro.","schema":{"type":"string","enum":["NFP","GDP","CPI"]},"example":"NFP"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroCard"}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/cpi/{id}":{"get":{"operationId":"getCpiCard","summary":"Inflation (CPI) card with category breakdown: US, UK, EA (euro area) or JP","tags":["paid"],"description":"US CPI inflation (CPI-U) card from the official BLS release: headline and core, year-over-year and month-over-month. $0.01 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Free trimmed sample (a labelled subset of this card, with its true counts): /sample/cpi/US.","parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from US, UK, EA (euro area) or JP.","schema":{"type":"string","enum":["US","UK","EA","JP"]},"example":"US"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroCard"}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/bundle/SEMIS":{"get":{"operationId":"getBundleSEMIS","summary":"Bundle SEMIS: AMD, MRVL, NVDA, AVGO, TSM, MU, AMAT, INTC, ASML in one call, cheaper than buying them one by one","tags":["paid"],"description":"SEC filing diff bundle: what changed in the latest 10-Q or 10-K for 9 semiconductor stocks in one call. $0.12 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Same card bodies as the individual routes, in one JSON (AMD, MRVL, NVDA, AVGO, TSM, MU, AMAT, INTC, ASML). Free single-card samples: /sample/{ticker}.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.12"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"bundle":{"type":"string","const":"SEMIS"},"title":{"type":"string"},"price":{"type":"string"},"count":{"type":"integer"},"ids":{"type":"array","items":{"type":"string"}},"cards":{"type":"array","items":{"$ref":"#/components/schemas/FilingCard"}}},"required":["bundle","count","ids","cards"]}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/bundle/CENTRALBANKS":{"get":{"operationId":"getBundleCENTRALBANKS","summary":"Bundle CENTRALBANKS: BOE, FED, ECB, BOJ, RBA, BOC, SNB in one call, cheaper than buying them one by one","tags":["paid"],"description":"Central-bank interest rate decision bundle: all 7 bank cards in one call. $0.08 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Same card bodies as the individual routes, in one JSON (BOE, FED, ECB, BOJ, RBA, BOC, SNB). Free single-card samples: /sample/policy/{id}.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"bundle":{"type":"string","const":"CENTRALBANKS"},"title":{"type":"string"},"price":{"type":"string"},"count":{"type":"integer"},"ids":{"type":"array","items":{"type":"string"}},"cards":{"type":"array","items":{"$ref":"#/components/schemas/PolicyCard"}}},"required":["bundle","count","ids","cards"]}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/bundle/BRICS":{"get":{"operationId":"getBundleBRICS","summary":"Bundle BRICS: BCB, IND, ZAF, CHN, RUS, IDN, ETH, EGY, IRN in one call, cheaper than buying them one by one","tags":["paid"],"description":"Central-bank interest rate decision bundle: all 9 bank cards in one call. $0.08 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Same card bodies as the individual routes, in one JSON (BCB, IND, ZAF, CHN, RUS, IDN, ETH, EGY, IRN). Free single-card samples: /sample/policy/{id}.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.08"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"bundle":{"type":"string","const":"BRICS"},"title":{"type":"string"},"price":{"type":"string"},"count":{"type":"integer"},"ids":{"type":"array","items":{"type":"string"}},"cards":{"type":"array","items":{"$ref":"#/components/schemas/PolicyCard"}}},"required":["bundle","count","ids","cards"]}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/insider/{ticker}":{"get":{"operationId":"getInsiderCard","summary":"Insider trades (SEC Form 4 and 4/A) for one ticker","tags":["paid"],"description":"Insider trades for one ticker from SEC Form 4 and 4/A filings in a recent filing-date window: each trade graded high, medium or low by the FilingDelta rubric (not SEC grading), with an EDGAR XML citation. $0.02 USDC on Base mainnet via x402 v2 (scheme exact, network eip155:8453, payTo 0x6d41a1B675cCF7980a0254d0C1317CccB4b42f2a). Free trimmed sample (a labelled subset of this card, with its true counts): /sample/insider/{ticker}.","parameters":[{"name":"ticker","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog insider.","schema":{"type":"string","enum":["NVDA"]},"example":"NVDA"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Paid card. The settlement receipt is in the PAYMENT-RESPONSE header (base64).","headers":{"PAYMENT-RESPONSE":{"description":"base64 x402 settlement response","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingCard"}}}},"402":{"description":"Payment Required. The x402 PaymentRequired object is base64 in the PAYMENT-REQUIRED header. Retry the same request with header PAYMENT-SIGNATURE: <base64 PaymentPayload>.","headers":{"PAYMENT-REQUIRED":{"description":"base64 x402 PaymentRequired","schema":{"type":"string"}}}},"404":{"description":"Unknown ticker (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_tickers":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_tickers","example"]}}}}}}},"/sample/insider/{ticker}":{"get":{"operationId":"getInsiderSample","summary":"Free trimmed sample of the insider-trade card (labelled in comparison_basis; the paid card has all items)","tags":["free"],"security":[],"parameters":[{"name":"ticker","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog free_insider_samples.","schema":{"type":"string","enum":["NVDA"]},"example":"NVDA"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingCard"}}}},"404":{"description":"Unknown ticker (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_tickers":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_tickers","example"]}}}}}}},"/sample/macro/{id}":{"get":{"operationId":"getMacroSample","summary":"Free trimmed sample of the US macro release card (labelled in comparison_basis; the paid card has all items)","tags":["free"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog macro.","schema":{"type":"string","enum":["NFP","GDP","CPI"]},"example":"NFP"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroCard"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/sample/history/{id}":{"get":{"operationId":"getHistorySample","summary":"Free sample quarterly history (AMD only; paid history not available)","tags":["free"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from free sample ids: AMD only.","schema":{"type":"string","enum":["AMD"]},"example":"AMD"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/free/uk/{id}":{"get":{"operationId":"getFreeUkCard","summary":"Free Bank of England / PRA summary card (own wording with source links; no payment; not a /policy id)","tags":["free"],"security":[],"parameters":[{"name":"id","in":"path","required":true,"description":"Uppercase; other casing gets a 301 to the uppercase id. Current values from /catalog cards (kind policy, free).","schema":{"type":"string","enum":["PRA-POLICY","BOE-FPC"]},"example":"PRA-POLICY"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown id (free 404, returned before any payment)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"requested":{"type":"string"},"valid_ids":{"type":"array","items":{"type":"string"}},"example":{"type":"string","description":"Concrete example URL"},"catalog":{"type":"string"}},"required":["error","valid_ids","example"]}}}}}}},"/catalog":{"get":{"operationId":"getCatalog","summary":"Tickers, policy ids, price, network and payTo","tags":["free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"filers":{"type":"array","items":{"type":"string"}},"policy":{"type":"array","items":{"type":"string"}},"free_samples":{"type":"array","items":{"type":"string"}},"free_policy_sample":{"type":"string"},"free_policy_samples":{"type":"array","items":{"type":"string"}},"paid_filings":{"type":"string"},"paid_filings_example":{"type":"string"},"paid_policy":{"type":"string"},"paid_policy_example":{"type":"string"},"macro":{"type":"array","items":{"type":"string"}},"free_macro_samples":{"type":"array","items":{"type":"string"}},"paid_macro":{"type":"string"},"paid_macro_example":{"type":"string"},"paid_macro_price":{"type":"string"},"free_cpi_sample":{"type":"string"},"paid_cpi":{"type":"string"},"cpi_ids":{"type":"array","items":{"type":"string"}},"paid_cpi_price":{"type":"string"},"guidance":{"type":"array","items":{"type":"string"}},"free_guidance_samples":{"type":"array","items":{"type":"string"}},"paid_guidance":{"type":"string"},"paid_guidance_price":{"type":"string"},"insider":{"type":"array","items":{"type":"string"}},"free_insider_samples":{"type":"array","items":{"type":"string"}},"paid_insider":{"type":"string"},"paid_insider_price":{"type":"string"},"macro_next_release":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"reference_period":{"type":"string"},"released":{"type":"string"},"next_release":{"type":"object","properties":{"date":{"type":"string"},"time":{"type":"string"},"reference_period":{"type":"string"},"source":{"type":"string"}},"required":["date","time","reference_period","source"]}},"required":["id","reference_period","released","next_release"]}},"bundles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"path":{"type":"string"},"title":{"type":"string"},"ids":{"type":"array","items":{"type":"string"}},"price":{"type":"string"},"individual_total":{"type":"string"},"discount":{"type":"string"},"content_hashes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"content_hash":{"type":"string"}},"required":["id","content_hash"]}}},"required":["id","path","title","ids","price","individual_total","discount","content_hashes"]}},"history":{"type":"string"},"paid_price":{"type":"string"},"network":{"type":"string"},"asset":{"type":"string"},"payTo":{"type":"string"},"freshness":{"type":"object","properties":{"filings":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"filing_date":{"type":"string"},"filing_type":{"type":"string"},"accession":{"type":"string"}},"required":["id","filing_date","filing_type","accession"]}},"policy":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"decision_date":{"type":"string"},"filing_type":{"type":"string"},"accession":{"type":"null"},"next_decision":{"type":["string","null"]}},"required":["id","decision_date","filing_type","accession","next_decision"]}}},"required":["filings","policy"]},"cards":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"as_of":{"type":"string"},"next_update":{"type":["string","null"]},"next_update_note":{"type":["string","null"]},"next_update_detail":{"type":["string","null"]},"content_hash":{"type":"string"}},"required":["id","kind","as_of","next_update","next_update_note","next_update_detail","content_hash"]}},"cards_notes":{"type":"object","properties":{"ids":{"type":"string"},"next_update":{"type":"string"},"content_hash":{"type":"string"}},"required":["ids","next_update","content_hash"]},"prices":{"type":"object","properties":{"/delta/:ticker":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/policy/:id":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/macro/:id":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/cpi/US":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/guidance/:ticker":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/insider/:ticker":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/bundle/SEMIS":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/bundle/CENTRALBANKS":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]},"/bundle/BRICS":{"type":"object","properties":{"price":{"type":"string"},"amount_base_units":{"type":"string"}},"required":["price","amount_base_units"]}},"required":["/delta/:ticker","/policy/:id","/macro/:id","/cpi/US","/guidance/:ticker","/insider/:ticker","/bundle/SEMIS","/bundle/CENTRALBANKS","/bundle/BRICS"]}},"required":["service","filers","policy","free_samples","free_policy_sample","free_policy_samples","paid_filings","paid_filings_example","paid_policy","paid_policy_example","macro","free_macro_samples","paid_macro","paid_macro_example","paid_macro_price","free_cpi_sample","paid_cpi","cpi_ids","paid_cpi_price","guidance","free_guidance_samples","paid_guidance","paid_guidance_price","insider","free_insider_samples","paid_insider","paid_insider_price","macro_next_release","bundles","history","paid_price","network","asset","payTo","freshness","cards","cards_notes","prices"]}}}}}}},"/updates":{"get":{"operationId":"getUpdates","summary":"Coverage changelog","tags":["free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"latest":{"type":"object","properties":{"date":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["date","tickers","note"]},"updates":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"tickers":{"type":"array","items":{"type":"string"}},"note":{"type":"string"}},"required":["date","tickers","note"]}}},"required":["service","latest","updates"]}}}}}}},"/.well-known/x402":{"get":{"operationId":"getX402Discovery","summary":"x402 discovery document","tags":["free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"x402Version":{"type":"integer"},"service":{"type":"string"},"description":{"type":"string"},"resources":{"type":"array","items":{"type":"object","properties":{"resource":{"type":"string"},"method":{"type":"string"},"description":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","properties":{"scheme":{"type":"string"},"network":{"type":"string"},"price":{"type":"string"},"payTo":{"type":"string"}},"required":["scheme","network","price","payTo"]}}},"required":["resource","method","description","accepts"]}}},"required":["x402Version","service","description","resources"]}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsTxt","summary":"Plain-text summary for LLMs","tags":["free"],"security":[],"responses":{"200":{"description":"OK","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/openapi.json":{"get":{"operationId":"getOpenApi","summary":"This document","tags":["free"],"security":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/mcp":{"post":{"operationId":"mcp","summary":"MCP server (JSON-RPC 2.0 over HTTP POST)","tags":["free"],"security":[],"description":"initialize, tools/list, tools/call. The endpoint is free; paid tools answer an unpaid tools/call with a normal result that has isError:true and the x402 PaymentRequired in structuredContent (JSON copy in content[0].text), the same object as the PAYMENT-REQUIRED header of the matching HTTP route. Pay by retrying the same tools/call with params._meta[\"x402/payment\"] (PaymentPayload) or header PAYMENT-SIGNATURE; the receipt is in result._meta[\"x402/payment-response\"] and the PAYMENT-RESPONSE header.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["string","integer","null"]},"method":{"type":"string"},"params":{"type":"object"}},"required":["jsonrpc","method"]}}}},"responses":{"200":{"description":"JSON-RPC response","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string"},"id":{},"result":{"type":"object"},"error":{"type":"object"}}}}}}}}}},"components":{"schemas":{"FilingCard":{"type":"object","properties":{"ticker":{"type":"string"},"source_url":{"type":"string"},"company":{"type":"string"},"period":{"type":"string"},"period_end":{"type":"string"},"filing_type":{"type":"string","description":"Free text as written on the card, not a normalised SEC form code. Current values: \"10-Q\", \"10-Q / earnings package\", \"earnings / 6-K package\", \"10-K\", \"6-K\", \"8-K\"."},"filing_date":{"type":"string"},"accession":{"type":"string"},"comparison_basis":{"type":"string"},"changes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"category":{"type":"string"},"summary":{"type":"string"},"materiality":{"type":"string"},"citation":{"type":"string"},"why_it_matters":{"type":"string"}},"required":["id","category","summary","materiality","citation","why_it_matters"]}},"new_material_items_count":{"type":"integer"},"high_materiality_count":{"type":"integer"},"generated_at":{"type":"string"}},"required":["ticker","source_url","company","period","period_end","filing_type","filing_date","comparison_basis","changes","new_material_items_count","high_materiality_count","generated_at"]},"PolicyCard":{"type":"object","properties":{"id":{"type":"string"},"institution":{"type":"string"},"body":{"type":"string"},"card_type":{"type":"string"},"decision":{"type":"string"},"bank_rate":{"type":"number"},"bank_rate_unit":{"type":"string"},"previous_bank_rate":{"type":"number"},"change_bps":{"type":"integer"},"vote":{"type":["string","null"]},"dissent":{"type":["string","null"]},"meeting_ended":{"type":"string"},"published":{"type":"string"},"next_decision":{"type":["string","null"]},"inflation":{"type":["number","null"]},"inflation_target":{"type":["null","number"]},"summary":{"type":"string"},"why_it_matters":{"type":"string"},"source_url":{"type":"string"},"generated_at":{"type":"string"}},"required":["id","institution","body","card_type","decision","bank_rate","bank_rate_unit","previous_bank_rate","change_bps","vote","dissent","meeting_ended","published","next_decision","inflation","inflation_target","summary","why_it_matters","source_url","generated_at"]},"MacroCard":{"type":"object","properties":{"id":{"type":"string"},"indicator":{"type":"string"},"agency":{"type":"string"},"release_title":{"type":"string"},"release_number":{"type":"string"},"reference_period":{"type":"string"},"released":{"type":"string"},"released_time":{"type":"string"},"source_url":{"type":"string"},"related_urls":{"type":"array","items":{"type":"string"}},"next_release":{"type":"object","properties":{"date":{"type":"string"},"time":{"type":"string"},"reference_period":{"type":"string"},"source":{"type":"string"}},"required":["date","time","reference_period","source"]},"comparison_basis":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"summary":{"type":"string"},"quote":{"type":"string"},"source":{"type":"string"}},"required":["id","summary","quote","source"]}},"generated_at":{"type":"string"}},"required":["id","indicator","agency","release_title","release_number","reference_period","released","released_time","source_url","related_urls","next_release","comparison_basis","items","generated_at"]}}}}