{"openapi":"3.1.0","info":{"title":"StockDatum API","version":"1.0.0","summary":"SEC EDGAR filings data for AI agents, paid per call in USDC via x402.","termsOfService":"https://api.stockdatum.com/terms","description":"SEC EDGAR filings data for agents, paid per call in USDC via x402 v2. No account and no API key: the agent pays per request. A valid request that returns zero rows is free. On /v1/8k, /v1/form4, /v1/form144 and /v1/clusters an unpaid call is HTTP 402 before parameters are checked; a verified payment with a bad parameter is HTTP 400 and is not charged. Making a paid request means accepting the terms; the person or organisation operating the agent is bound by its calls. Not investment advice. StockDatum is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is.","contact":{"name":"Franck Labs Ltd","email":"data@stockdatum.com","url":"https://stockdatum.com"},"x-guidance":"Paid routes are GET /v1/8k, GET /v1/form4, GET /v1/form144 and GET /v1/clusters. Call one with no payment header, including a call with no query string, to receive HTTP 402, a base64 PAYMENT-REQUIRED header (x402 v2, scheme exact, USDC) and a JSON body with a non-empty accepts array. Sign that challenge and retry with PAYMENT-SIGNATURE. An unpaid call is HTTP 402 before parameters are checked. A verified payment with a bad parameter is HTTP 400 and is not charged. A valid request that returns zero rows is free. Prices are on /pricing."},"servers":[{"url":"https://api.stockdatum.com","description":"Production"}],"tags":[{"name":"8-K and 6-K","description":"SEC 8-K/6-K filings with item tags. Paid per call (x402)."},{"name":"Form 4","description":"SEC Form 4 insider transaction lines. Paid per call (x402)."},{"name":"Form 144","description":"SEC Form 144 proposed-sale notices with Form 4 match status. Paid per call (x402)."},{"name":"Insider purchase clusters","description":"Insider purchase clusters from SEC Form 4 filings (latest run). Paid per call (x402)."},{"name":"Free","description":"Routes that are not charged: health, status, probe, pricing, samples, docs, terms and privacy."}],"components":{"schemas":{"FilingTimes":{"type":"object","description":"Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is.","properties":{"filed_date":{"type":"string","description":"filed_date. Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is."},"accepted_et":{"type":"string","description":"accepted_et. Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is."},"accepted_utc":{"type":"string","description":"accepted_utc. Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is."},"accepted_uk":{"type":"string","description":"accepted_uk. Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is."}}}}},"paths":{"/health":{"get":{"tags":["Free"],"summary":"Liveness and checks","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/probe":{"get":{"tags":["Free"],"summary":"Latest real filing row per dataset, data_as_of_utc and prices","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/pricing":{"get":{"tags":["Free"],"summary":"Price table","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/status":{"get":{"tags":["Free"],"summary":"Freshness per dataset","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/docs":{"get":{"tags":["Free"],"summary":"API overview, including the filing-time known issue","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/llms.txt":{"get":{"tags":["Free"],"summary":"Agent-readable description","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/llms-full.txt":{"get":{"tags":["Free"],"summary":"Agent-readable description plus the filing-time fields","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/openapi.json":{"get":{"tags":["Free"],"summary":"This document","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/.well-known/x402":{"get":{"tags":["Free"],"summary":"x402 discovery document for paid routes","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/terms":{"get":{"tags":["Free"],"summary":"Terms of use (markdown)","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/privacy":{"get":{"tags":["Free"],"summary":"Privacy notice (markdown)","security":[],"responses":{"200":{"description":"OK"},"429":{"description":"Rate limited (retry-after: 60)"}}}},"/sample/{dataset}":{"get":{"tags":["Free"],"summary":"The 5 newest rows of a dataset that are at least 24 hours old (free)","security":[],"parameters":[{"name":"dataset","in":"path","required":true,"schema":{"type":"string","enum":["8k","form4","form144","clusters"]}}],"responses":{"200":{"description":"OK"},"404":{"description":"Unknown dataset"},"503":{"description":"dataset_not_loaded"}}}},"/v1/8k":{"get":{"tags":["8-K and 6-K"],"summary":"8-K / 6-K filings with item tags","description":"SEC 8-K/6-K filings with item tags. Price 0.02 USDC per call; a valid request returning zero rows is free. Making a paid request means accepting the terms; the person or organisation operating the agent is bound by its calls.","parameters":[{"name":"ticker","in":"query","required":false,"description":"Ticker symbol","schema":{"type":"string","description":"Ticker symbol","pattern":"^[A-Za-z0-9.\\-]{1,10}$"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK, 1-10 digits","schema":{"type":"string","description":"SEC CIK, 1-10 digits","pattern":"^\\d{1,10}$"}},{"name":"form","in":"query","required":false,"description":"Form type","schema":{"type":"string","description":"Form type","enum":["8-K","8-K/A","6-K","6-K/A"]}},{"name":"since","in":"query","required":false,"description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","schema":{"type":"string","description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","format":"date"}},{"name":"tag","in":"query","required":false,"description":"One of the 0/1 tag columns; returns rows where it is 1","schema":{"type":"string","description":"One of the 0/1 tag columns; returns rows where it is 1","enum":["auditor_change","bankruptcy","cyber","delisting_notice","earnings_notice","equity_issue","exec_change","exhibits","financing","governance","holder_rights","impairment","listing_transfer","material_agreement","merger_delisting","monthly_sales","non_reliance","other","other_events","reg_fd","restructuring","shareholder_vote"]}},{"name":"limit","in":"query","required":false,"description":"1-200, default 50 (not clamped: out of range is a 400)","schema":{"type":"integer","description":"1-200, default 50 (not clamped: out of range is a 400)","minimum":1,"maximum":200}}],"x-price-usdc":"0.02","x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000","payTo":"0x4aB98228FD419cE7Ca07d702000477D66b63C468"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Rows. Header PAYMENT-RESPONSE (base64 settlement) when the call settled."},"400":{"description":"Bad parameter after a verified payment (not charged) or payment_malformed. On /v1/8k, /v1/form4, /v1/form144 and /v1/clusters an unpaid call is 402 before parameters are checked."},"402":{"description":"Payment required (x402 v2). Header PAYMENT-REQUIRED (base64 JSON, unchanged v2 object). JSON body has x402Version and a non-empty accepts array. Price 0.02 USDC.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 PaymentRequired"}}},"429":{"description":"Rate limited"},"503":{"description":"terms_not_published, dataset_not_loaded, capacity_paused or facilitator_unavailable"}}}},"/v1/form4":{"get":{"tags":["Form 4"],"summary":"Form 4 insider transactions (one row per transaction line)","description":"SEC Form 4 insider transaction lines. Price 0.02 USDC per call; a valid request returning zero rows is free. Making a paid request means accepting the terms; the person or organisation operating the agent is bound by its calls.","parameters":[{"name":"ticker","in":"query","required":false,"description":"Ticker symbol (ticker or cik required)","schema":{"type":"string","description":"Ticker symbol (ticker or cik required)","pattern":"^[A-Za-z0-9.\\-]{1,10}$"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK, 1-10 digits (ticker or cik required)","schema":{"type":"string","description":"SEC CIK, 1-10 digits (ticker or cik required)","pattern":"^\\d{1,10}$"}},{"name":"since","in":"query","required":false,"description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","schema":{"type":"string","description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","format":"date"}},{"name":"code","in":"query","required":false,"description":"One Form 4 transaction code, e.g. P, S","schema":{"type":"string","description":"One Form 4 transaction code, e.g. P, S","pattern":"^[A-Za-z]$"}},{"name":"limit","in":"query","required":false,"description":"1-200, default 50 (not clamped: out of range is a 400)","schema":{"type":"integer","description":"1-200, default 50 (not clamped: out of range is a 400)","minimum":1,"maximum":200}}],"x-price-usdc":"0.02","x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000","payTo":"0x4aB98228FD419cE7Ca07d702000477D66b63C468"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Rows. Header PAYMENT-RESPONSE (base64 settlement) when the call settled."},"400":{"description":"Bad parameter after a verified payment (not charged) or payment_malformed. On /v1/8k, /v1/form4, /v1/form144 and /v1/clusters an unpaid call is 402 before parameters are checked."},"402":{"description":"Payment required (x402 v2). Header PAYMENT-REQUIRED (base64 JSON, unchanged v2 object). JSON body has x402Version and a non-empty accepts array. Price 0.02 USDC.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 PaymentRequired"}}},"429":{"description":"Rate limited"},"503":{"description":"terms_not_published, dataset_not_loaded, capacity_paused or facilitator_unavailable"}}}},"/v1/form144":{"get":{"tags":["Form 144"],"summary":"Form 144 proposed-sale notices with Form 4 match status","description":"SEC Form 144 proposed-sale notices with Form 4 match status. Price 0.02 USDC per call; a valid request returning zero rows is free. Making a paid request means accepting the terms; the person or organisation operating the agent is bound by its calls.","parameters":[{"name":"ticker","in":"query","required":false,"description":"Ticker symbol (ticker or cik required)","schema":{"type":"string","description":"Ticker symbol (ticker or cik required)","pattern":"^[A-Za-z0-9.\\-]{1,10}$"}},{"name":"cik","in":"query","required":false,"description":"SEC CIK, 1-10 digits (ticker or cik required)","schema":{"type":"string","description":"SEC CIK, 1-10 digits (ticker or cik required)","pattern":"^\\d{1,10}$"}},{"name":"since","in":"query","required":false,"description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","schema":{"type":"string","description":"YYYY-MM-DD; filters filed_date >= since. Rows sort by accepted_utc, and after-hours filings carry the next day's filed_date.","format":"date"}},{"name":"status","in":"query","required":false,"description":"Match status","schema":{"type":"string","description":"Match status","enum":["OPEN","PARTIAL","CLOSED","EXPIRED","SUPERSEDED","DUPLICATE"]}},{"name":"limit","in":"query","required":false,"description":"1-200, default 50 (not clamped: out of range is a 400)","schema":{"type":"integer","description":"1-200, default 50 (not clamped: out of range is a 400)","minimum":1,"maximum":200}}],"x-price-usdc":"0.02","x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"20000","payTo":"0x4aB98228FD419cE7Ca07d702000477D66b63C468"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.02"}},"responses":{"200":{"description":"Rows. Header PAYMENT-RESPONSE (base64 settlement) when the call settled."},"400":{"description":"Bad parameter after a verified payment (not charged) or payment_malformed. On /v1/8k, /v1/form4, /v1/form144 and /v1/clusters an unpaid call is 402 before parameters are checked."},"402":{"description":"Payment required (x402 v2). Header PAYMENT-REQUIRED (base64 JSON, unchanged v2 object). JSON body has x402Version and a non-empty accepts array. Price 0.02 USDC.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 PaymentRequired"}}},"429":{"description":"Rate limited"},"503":{"description":"terms_not_published, dataset_not_loaded, capacity_paused or facilitator_unavailable"}}}},"/v1/clusters":{"get":{"tags":["Insider purchase clusters"],"summary":"Insider purchase clusters (latest run only)","description":"Insider purchase clusters from SEC Form 4 filings (latest run). Price 0.03 USDC per call; a valid request returning zero rows is free. Making a paid request means accepting the terms; the person or organisation operating the agent is bound by its calls.","parameters":[{"name":"ticker","in":"query","required":false,"description":"Ticker symbol","schema":{"type":"string","description":"Ticker symbol","pattern":"^[A-Za-z0-9.\\-]{1,10}$"}},{"name":"view","in":"query","required":false,"description":"default = default_view=1 rows (default); all = every row of the latest run","schema":{"type":"string","description":"default = default_view=1 rows (default); all = every row of the latest run","enum":["default","all"]}},{"name":"limit","in":"query","required":false,"description":"1-200, default 50 (not clamped: out of range is a 400)","schema":{"type":"integer","description":"1-200, default 50 (not clamped: out of range is a 400)","minimum":1,"maximum":200}}],"x-price-usdc":"0.03","x-x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","amount":"30000","payTo":"0x4aB98228FD419cE7Ca07d702000477D66b63C468"},"x-payment-info":{"protocols":[{"x402":{}}],"price":{"mode":"fixed","currency":"USD","amount":"0.03"}},"responses":{"200":{"description":"Rows. Header PAYMENT-RESPONSE (base64 settlement) when the call settled."},"400":{"description":"Bad parameter after a verified payment (not charged) or payment_malformed. On /v1/8k, /v1/form4, /v1/form144 and /v1/clusters an unpaid call is 402 before parameters are checked."},"402":{"description":"Payment required (x402 v2). Header PAYMENT-REQUIRED (base64 JSON, unchanged v2 object). JSON body has x402Version and a non-empty accepts array. Price 0.03 USDC.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 PaymentRequired"}}},"429":{"description":"Rate limited"},"503":{"description":"terms_not_published, dataset_not_loaded, capacity_paused or facilitator_unavailable"}}}}}}