StockDatum API docs
SEC filing data for AI agents, paid per call in USDC on Base over x402. No account and no API key. The API base is https://api.stockdatum.com.
On this page
Quickstart How payment works Endpoints and parameters Free routes Errors and when you are not charged Field reference Machine-readable Terms and privacyQuickstart
# Free: real rows, no payment curl https://api.stockdatum.com/sample/form4 # Paid: the first call returns the price curl -i "https://api.stockdatum.com/v1/form4?ticker=RAPP&limit=50" HTTP/2 402 payment-required: eyJ4NDAyVmVyc2lvbiI6Miwi… # Your x402 client signs 0.02 USDC on Base, # retries with PAYMENT-SIGNATURE and gets the rows.
The payment-required value above is the start of the live header. It is base64 for an x402 v2 object. The rows in the free sample are real filing rows.
How payment works
Paid routes use x402 v2, scheme exact, on Base (eip155:8453), in USDC. An unpaid call returns HTTP 402 with a base64 PAYMENT-REQUIRED header and a JSON body whose accepts array is non-empty. Sign that challenge and retry with PAYMENT-SIGNATURE. v1 clients that send X-PAYMENT receive the v2 challenge.
Form 4, 8-K/6-K and Form 144 are $0.02 a call. Clusters are $0.03 a call. Each price is flat for up to 200 rows. The amount is stated in the 402 response.
Endpoints and parameters
All four routes are GET. limit is an integer from 1 to 200, default 50. A value outside that range is a 400 after the 402 step, and isn't charged. since is YYYY-MM-DD and filters filed_date. Rows sort by accepted_utc.
GET /v1/form4 · $0.02
https://api.stockdatum.com/v1/form4
ticker, cik, since, code, limit. code is one Form 4 transaction letter, for example P or S. Pass ticker or cik.
GET /v1/8k · $0.02
https://api.stockdatum.com/v1/8k
ticker, cik, form, since, tag, limit. form is 8-K, 8-K/A, 6-K or 6-K/A. tag is one of the 0/1 columns and returns rows where it is 1.
GET /v1/form144 · $0.02
https://api.stockdatum.com/v1/form144
ticker, cik, since, status, limit. status is OPEN, PARTIAL, CLOSED, EXPIRED, SUPERSEDED or DUPLICATE. Pass ticker or cik.
GET /v1/clusters · $0.03
https://api.stockdatum.com/v1/clusters
ticker, view, limit. view=default returns rows with default_view 1. view=all returns every row of the latest run.
Free routes
- /sample/{dataset} returns example filing rows with no payment. Datasets: 8k, form4, form144, clusters.
- /probe returns a latest row per dataset,
data_as_of_utcand prices. - /health, /status, /pricing, /openapi.json, /llms.txt, /llms-full.txt, /terms and /privacy.
Errors and when you are not charged
An unpaid call always gets the 402 price first. After payment is verified, a bad parameter returns HTTP 400 and isn't charged, and a call that finds no rows is never settled. If a payment fails or is pending, the rows are withheld and you aren't charged.
An unpaid call to a paid route is HTTP 402. A request the server rejects for a bad parameter is not charged. A response with count 0 is not settled.
Field reference
Issuers are shown by ticker. The type is the JSON type. Any field can be null. Flags are integers, 0 or 1. Dates are YYYY-MM-DD. Times are ISO-8601 with an offset.
Known issue (v1): filing times are included, but run reliability is still being proven. We'll remove this note once it is.
8-K and 6-K
GET /v1/8k · $0.02 per call
| Field | Type | Meaning |
|---|---|---|
accession | string | SEC accession number ##########-YY-######; primary key of the dataset. |
form | string | Filing form type as in the EDGAR header: 8-K, 8-K/A, 6-K, 6-K/A (the four values the form filter accepts). |
cik | integer | SEC CIK of the subject company: the first CIK in the filing header. |
ticker | string | Trading symbol mapped from the CIK. |
figi | string | Not populated in v1: always null. |
company_name | string | Conformed company name from the filing header (first listed name). |
filed_date Known issue | string | The filing date on the EDGAR header, YYYY-MM-DD (the since filter works on it). |
accepted_et Known issue | string | EDGAR acceptance timestamp, US Eastern, ISO-8601 with offset: -04:00 during US daylight time, -05:00 otherwise (in 2026 the change is Sunday 1 November: -04:00 up to then, -05:00 from then). |
accepted_utc Known issue | string | The same instant in UTC, ISO-8601 +00:00. |
accepted_uk Known issue | string | The same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise). |
period | string | Header PERIOD (period of report) as YYYY-MM-DD: the event date for an 8-K, the reporting date for a 6-K. |
items | string | Comma-separated 8-K item codes as filed in the header. |
url | string | EDGAR filing index page for the accession. |
auditor_change | integer | 1 = Item 4.01 (change of the company's auditor). |
bankruptcy | integer | 1 = Item 1.03 (bankruptcy or receivership). |
cyber | integer | 1 = Item 1.05 (material cybersecurity incident). |
delisting_notice | integer | 1 = Item 3.01 (notice of delisting or failure to meet a listing rule). |
earnings_notice | integer | 1 = a results date or conference-call notice. |
equity_issue | integer | 1 = Item 3.02 (unregistered sale of equity securities), or offering, at-the-market or placement wording in the text of other items (1.01, 7.01, 8.01). |
exec_change | integer | 1 = Item 5.02 (director or officer departure, appointment or compensation). |
exhibits | integer | 1 = Item 9.01 (financial statements and exhibits). |
financing | integer | 1 = Item 2.03 (creation of a direct financial obligation) or 2.04 (acceleration trigger). |
governance | integer | 1 = Items 5.03 to 5.06 and 5.08 (charter or bylaw change, trading suspension under benefit plans, code of ethics, shell status, director nominations). |
holder_rights | integer | 1 = Item 3.03 (material modification of the rights of security holders). |
impairment | integer | 1 = Item 2.06 (material impairment). |
listing_transfer | integer | 1 = Item 3.01 used for a voluntary move of the listing to another exchange (text-derived; distress wording keeps delisting_notice). |
material_agreement | integer | 1 = Item 1.01 (entry into) or 1.02 (termination of) a material definitive agreement. |
merger_delisting | integer | 1 = Item 3.01 filed because a COMPLETED takeover delisted the company's shares (3.01 with 2.01 or 5.01), not distress. |
monthly_sales | integer | 1 = a monthly revenue/sales/delivery report. |
non_reliance | integer | 1 = Item 4.02 (non-reliance on previously issued financial statements). |
other | integer | 1 = items with no dedicated tag (1.04 mine safety, 6.01 to 6.05 asset-backed-securities items) or an item code the table does not know. |
other_events | integer | 1 = Item 8.01 (other events). |
reg_fd | integer | 1 = Item 7.01 (Regulation FD disclosure). |
restructuring | integer | 1 = Item 2.05 (exit or disposal costs). |
shareholder_vote | integer | 1 = Item 5.07 (submission of matters to a vote of security holders). |
results_basis | string | How results was decided: item_code for an 8-K Item 2.02, 8k_text from an exhibit headline on an 8-K with no Item 2.02 (a body or boilerplate mention of results does not tag), or 6k_text. |
figi is on the v1 row and is not populated in v1. The value is always null.
Form 4
GET /v1/form4 · $0.02 per call
| Field | Type | Meaning |
|---|---|---|
accession | string | Accession number of the Form 4 / 4/A filing. |
seq | integer | Row number within the filing, from 0, counted across the non-derivative table first and then the derivative table, in document order. |
form | string | 4 (original) or 4/A (amendment). |
issuer_cik | integer | CIK of the company whose securities were traded (issuerCik). |
issuer_ticker | string | Trading symbol typed by the filer (issuerTradingSymbol), upper-cased and trimmed, with these clean-ups: placeholders such as NONE, N/A and digits-only text become empty (NULL). |
issuer_name | string | issuerName from the filing. |
insider_cik | integer | CIK of the first reporting owner in our data. |
insider_name | string | Names of all reporting owners on the filing, joined with ;. |
is_director | integer | 1 if the FIRST reporting owner (see insider_cik) ticked Director. |
is_officer | integer | 1 if the FIRST reporting owner (see insider_cik) ticked Officer. |
is_10pct | integer | 1 if the FIRST reporting owner (see insider_cik) ticked 10% owner. |
is_other | integer | 1 if the FIRST reporting owner (see insider_cik) ticked Other. |
officer_title | string | Officer title typed by the first owner (officerTitle), as filed. |
role | string | Text built by us (not as filed) from the first owner's boxes, joined with , : Director; the typed officer title (or Officer if no title) when Officer is ticked. |
table_type | string | nonDerivative (Table I: shares) or derivative (Table II: options, RSUs, warrants). |
security | string | securityTitle of the instrument. |
txn_date | string | Transaction date as typed by the filer, YYYY-MM-DD; not validated. |
code | string | SEC Form 4 transaction code, one letter. |
acq_disp | string | A acquired or D disposed (transactionAcquiredDisposedCode). |
shares | number | Number of securities in the line as filed (transactionShares); not split-adjusted. |
price | number | Price per security in USD as filed (transactionPricePerShare). |
value | number | shares x price, computed by us. |
owned_after | number | sharesOwnedFollowingTransaction: the holding after this line, as filed, in the line's own unit (shares on Table I; derivative securities on Table II). |
direct_indirect | string | D held directly or I held indirectly (through a trust, entity or family member). |
plan_10b5_1 | integer | 1 if the filing's 10b5-1 checkbox is ticked OR any footnote or remark anywhere on the filing contains the text 10b5-1. |
aff10b5one | integer | The form's own Rule 10b5-1 checkbox for the whole filing: 1 ticked, 0 not ticked. |
filed_date Known issue | string | EDGAR filing date YYYY-MM-DD as a US Eastern calendar date. |
accepted_et Known issue | string | Acceptance time on EDGAR, US Eastern, ISO-8601 with offset (-04:00 until Sun 1 Nov 2026, -05:00 from then), read from the filing's SGML header / index page. |
accepted_utc Known issue | string | The same instant in UTC, ISO-8601 +00:00. |
accepted_uk Known issue | string | The same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise). |
url | string | Link to the filing's full submission text file on sec.gov (.txt, which contains the Form 4 XML), not the filing's index page. |
Form 144
GET /v1/form144 · $0.02 per call
| Field | Type | Meaning |
|---|---|---|
accession | string | Accession of the Form 144 (or 144/A) notice; primary key. |
form | string | 144 or 144/A (amendment of an earlier notice). |
issuer_cik | integer | CIK of the company whose shares are to be sold. |
issuer_ticker | string | Ticker of the issuer. |
issuer_name | string | Issuer name from the notice. |
filer_cik | integer | CIK of the person or entity filing the notice (the seller's CIK, not the issuer's). |
seller_name | string | Name of the person or entity selling, as on the notice. |
relationship | string | Seller's relationship to the issuer as filed, free text joined with ;. |
security_class | string | Class of security to be sold, as filed. |
units_to_sell | number | Number of shares/units the notice proposes to sell. |
aggregate_value | number | Aggregate market value of those units in USD, as the filer states it at filing. |
units_outstanding | number | Shares of the class outstanding, as the filer states it. |
approx_sale_date | string | Approximate date of sale on the notice, YYYY-MM-DD. |
exchange | string | Exchange named on the notice. |
broker | string | Broker or market-maker named on the notice. |
acquired_how | string | How the seller acquired the shares, free text as filed (Restricted Stock Vesting, Stock Option Exercise, Founders Shares...). |
plan_adoption_date | string | 10b5-1 plan adoption date(s), YYYY-MM-DD, ;-joined when several. |
plan_adoption_source | string | Which source supplied plan_adoption_date: the Form 144 notice, or the Form 4 footnote ("adopted on ...") when the notice has none. |
sold_past_3m_units | number | Units the seller already sold in the past 3 months, as the notice states. |
filed_date Known issue | string | Filing date YYYY-MM-DD. |
accepted_et Known issue | string | EDGAR acceptance timestamp, US Eastern, ISO-8601 with offset: -04:00 during US daylight time, -05:00 otherwise (in 2026 the change is Sunday 1 November: -04:00 up to then, -05:00 from then). |
accepted_utc Known issue | string | The same instant in UTC, ISO-8601 +00:00. |
accepted_uk Known issue | string | The same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise). |
url | string | EDGAR URL of the notice. |
amends_accession | string | For a 144/A: accession of the notice it amends. |
status | string | Match status against later Form 4 sales: OPEN, PARTIAL (some matched, under 99% of the notice's units), CLOSED (at least 99% matched), EXPIRED, SUPERSEDED (a 144/A replaces the original), or DUPLICATE (an exact re-filing). |
window_end | string | Last day on which a Form 4 sale can be credited to the notice: 90 days after the later of the approximate sale date and the filing date. |
superseded_by | string | Accession of the 144/A that supersedes this notice (status SUPERSEDED). |
duplicate_of | string | Accession of the earlier identical notice (status DUPLICATE). |
f4_shares_sold | number | Shares from matching Form 4 sale lines credited to this notice. |
f4_pct_of_144 | number | 100 * f4_shares_sold / units_to_sell, 1 decimal. |
f4_value_sold | number | USD value of those credited sale lines (shares x price), 2 decimals. |
f4_first_sale | string | Earliest transaction date among the credited Form 4 lines. |
f4_last_sale | string | Latest transaction date among the credited Form 4 lines. |
f4_accessions | string | ;-joined accessions of the Form 4 filings credited. |
multi_filer_same_sale | integer | 1 when several filers (e.g. co-trustees) reported the same sale in identical lines and it was credited once. |
generated_at_utc | string | UTC time the match table was last rebuilt (...Z). |
Clusters
GET /v1/clusters · $0.03 per call
| Field | Type | Meaning |
|---|---|---|
run_date | string | Date the cluster run was made for (YYYY-MM-DD); the end of the window. |
generated_at_utc | string | UTC time the run was made (...Z). |
window_days | integer | Look-back length: window_start is window_end minus this many days (30 now, a current setting). |
window_start | string | First day of the window: window_end minus window_days. |
window_end | string | Last day of the window (= run_date). |
issuer_cik | integer | CIK of the issuer. |
security_class | string | Share class of the buys: Class A, Class B... when the security title names a letter class, otherwise Common. |
issuer_name | string | Issuer name (latest in the window). |
ticker | string | Ticker for the issuer and class: the symbol on the filings, else the issuer's own ticker in SEC records; a second class uses its suffix ticker with a dot (ABC.A). |
n_insiders | integer | Number of distinct owner groups with at least one counted buy in the window. |
n_insiders_min_value | integer | How many of those insiders bought at least $10,000 each (priced buys, window total). |
n_token_insiders | integer | Insiders whose priced buys total more than $0 but under $10,000: counted in n_insiders, not in n_insiders_min_value. |
token_insiders | string | First-listed name of each insider whose priced purchases in the window are above zero and under $10,000, sorted and joined with ; . |
n_insiders_unpriced | integer | Insiders with buys but no usable price (no dollar value). |
n_buys | integer | Number of open-market purchase lines counted: Form 4 code P, non-derivative, not preferred, excluding plan lines (including dividend reinvestment and 10b5-1 plans) and identical-price blocks of three or more insiders in the same class on the same day at the same price. |
n_buys_no_price | integer | Buy lines with no usable price: counted in n_buys, excluded from total_value. |
total_value | number | USD value of the priced buy lines: shares x price, where the price is the Form 4 price, or, when that box is blank or 0, the weighted-average price stated in the footnote. |
top_insider_pct | number | Largest single insider's share of the priced dollars, percent, 1 decimal. |
first_txn | string | Earliest transaction date among the buys. |
last_txn | string | Latest transaction date among the buys. |
insiders | string | First-listed name of each owner group, sorted and joined with ; . |
joint_filers | string | Other owner names on a joint filing that were merged into the owner group, sorted and joined with ; . |
roles | string | Officer title where one is present, otherwise the role text, for each owner group, sorted and joined with ; . |
ceo_cfo | integer | 1 if any of those titles contains CEO, chief executive, CFO or chief financial (case-insensitive). |
identical_price_buys | integer | Always 0 in v1. |
n_late_buys | integer | Buy lines whose Form 4 was filed more than 2 weekdays (Mon-Fri) after the transaction date. |
late_filed | integer | 1 if n_late_buys is above 0: at least one counted buy was reported late, so the cluster may not have been visible in full when the buys were made. |
late_accessions | string | Accessions of the late Form 4s, joined with ; (no space). |
sic | string | SIC code of the issuer from its EDGAR record; empty text when SEC has none. |
sector_sic | string | EDGAR's sicDescription for that code; empty text (not NULL) when none. |
fund_flag | integer | 1 if the issuer's recent SEC filings include investment-company forms (such as N-CSR, N-CSRS, N-2, NPORT-P, N-CEN, N-PX, N-8F, N-1A, 485BPOS) or its SIC code is 6726. |
n_first_buy_12m | integer | Number of owner groups with no Form 4 purchase (P) of this issuer filed in the 365 days before the group's first buy in the window. |
n_first_buy_unknown | integer | Number of groups whose history was not read because that owner filed more than 40 Form 4s in the 365 days (any issuer). |
first_buy_12m_flag | integer | 1 if at least one insider's buy was a first in 12 months. |
n_10b5_1_buys_excluded | number | Number of buys in the same issuer, class and window left out because the buy line's own footnotes, or the Form 4 remarks, say it was made under a Rule 10b5-1 plan. |
n_10b5_1_insiders | number | Distinct owner groups behind those plan buys. |
cluster_class | string | fund if fund_flag = 1, else discretionary. |
default_view | integer | 1 if cluster_class = discretionary AND n_insiders_min_value >= 3. |
identical_price_buys is on the v1 row. In v1 the value is always 0.
The four time fields marked above are filed_date, accepted_et, accepted_utc and accepted_uk. Clusters do not have them.
Machine-readable
Terms and privacy
Read the terms and the privacy notice. The same texts are served on the API at /terms and /privacy.