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 privacy

Quickstart

# 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

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

FieldTypeMeaning
accessionstringSEC accession number ##########-YY-######; primary key of the dataset.
formstringFiling form type as in the EDGAR header: 8-K, 8-K/A, 6-K, 6-K/A (the four values the form filter accepts).
cikintegerSEC CIK of the subject company: the first CIK in the filing header.
tickerstringTrading symbol mapped from the CIK.
figistringNot populated in v1: always null.
company_namestringConformed company name from the filing header (first listed name).
filed_date Known issuestringThe filing date on the EDGAR header, YYYY-MM-DD (the since filter works on it).
accepted_et Known issuestringEDGAR 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 issuestringThe same instant in UTC, ISO-8601 +00:00.
accepted_uk Known issuestringThe same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise).
periodstringHeader PERIOD (period of report) as YYYY-MM-DD: the event date for an 8-K, the reporting date for a 6-K.
itemsstringComma-separated 8-K item codes as filed in the header.
urlstringEDGAR filing index page for the accession.
auditor_changeinteger1 = Item 4.01 (change of the company's auditor).
bankruptcyinteger1 = Item 1.03 (bankruptcy or receivership).
cyberinteger1 = Item 1.05 (material cybersecurity incident).
delisting_noticeinteger1 = Item 3.01 (notice of delisting or failure to meet a listing rule).
earnings_noticeinteger1 = a results date or conference-call notice.
equity_issueinteger1 = 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_changeinteger1 = Item 5.02 (director or officer departure, appointment or compensation).
exhibitsinteger1 = Item 9.01 (financial statements and exhibits).
financinginteger1 = Item 2.03 (creation of a direct financial obligation) or 2.04 (acceleration trigger).
governanceinteger1 = 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_rightsinteger1 = Item 3.03 (material modification of the rights of security holders).
impairmentinteger1 = Item 2.06 (material impairment).
listing_transferinteger1 = Item 3.01 used for a voluntary move of the listing to another exchange (text-derived; distress wording keeps delisting_notice).
material_agreementinteger1 = Item 1.01 (entry into) or 1.02 (termination of) a material definitive agreement.
merger_delistinginteger1 = Item 3.01 filed because a COMPLETED takeover delisted the company's shares (3.01 with 2.01 or 5.01), not distress.
monthly_salesinteger1 = a monthly revenue/sales/delivery report.
non_relianceinteger1 = Item 4.02 (non-reliance on previously issued financial statements).
otherinteger1 = 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_eventsinteger1 = Item 8.01 (other events).
reg_fdinteger1 = Item 7.01 (Regulation FD disclosure).
restructuringinteger1 = Item 2.05 (exit or disposal costs).
shareholder_voteinteger1 = Item 5.07 (submission of matters to a vote of security holders).
results_basisstringHow 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

FieldTypeMeaning
accessionstringAccession number of the Form 4 / 4/A filing.
seqintegerRow number within the filing, from 0, counted across the non-derivative table first and then the derivative table, in document order.
formstring4 (original) or 4/A (amendment).
issuer_cikintegerCIK of the company whose securities were traded (issuerCik).
issuer_tickerstringTrading 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_namestringissuerName from the filing.
insider_cikintegerCIK of the first reporting owner in our data.
insider_namestringNames of all reporting owners on the filing, joined with ;.
is_directorinteger1 if the FIRST reporting owner (see insider_cik) ticked Director.
is_officerinteger1 if the FIRST reporting owner (see insider_cik) ticked Officer.
is_10pctinteger1 if the FIRST reporting owner (see insider_cik) ticked 10% owner.
is_otherinteger1 if the FIRST reporting owner (see insider_cik) ticked Other.
officer_titlestringOfficer title typed by the first owner (officerTitle), as filed.
rolestringText 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_typestringnonDerivative (Table I: shares) or derivative (Table II: options, RSUs, warrants).
securitystringsecurityTitle of the instrument.
txn_datestringTransaction date as typed by the filer, YYYY-MM-DD; not validated.
codestringSEC Form 4 transaction code, one letter.
acq_dispstringA acquired or D disposed (transactionAcquiredDisposedCode).
sharesnumberNumber of securities in the line as filed (transactionShares); not split-adjusted.
pricenumberPrice per security in USD as filed (transactionPricePerShare).
valuenumbershares x price, computed by us.
owned_afternumbersharesOwnedFollowingTransaction: the holding after this line, as filed, in the line's own unit (shares on Table I; derivative securities on Table II).
direct_indirectstringD held directly or I held indirectly (through a trust, entity or family member).
plan_10b5_1integer1 if the filing's 10b5-1 checkbox is ticked OR any footnote or remark anywhere on the filing contains the text 10b5-1.
aff10b5oneintegerThe form's own Rule 10b5-1 checkbox for the whole filing: 1 ticked, 0 not ticked.
filed_date Known issuestringEDGAR filing date YYYY-MM-DD as a US Eastern calendar date.
accepted_et Known issuestringAcceptance 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 issuestringThe same instant in UTC, ISO-8601 +00:00.
accepted_uk Known issuestringThe same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise).
urlstringLink 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

FieldTypeMeaning
accessionstringAccession of the Form 144 (or 144/A) notice; primary key.
formstring144 or 144/A (amendment of an earlier notice).
issuer_cikintegerCIK of the company whose shares are to be sold.
issuer_tickerstringTicker of the issuer.
issuer_namestringIssuer name from the notice.
filer_cikintegerCIK of the person or entity filing the notice (the seller's CIK, not the issuer's).
seller_namestringName of the person or entity selling, as on the notice.
relationshipstringSeller's relationship to the issuer as filed, free text joined with ;.
security_classstringClass of security to be sold, as filed.
units_to_sellnumberNumber of shares/units the notice proposes to sell.
aggregate_valuenumberAggregate market value of those units in USD, as the filer states it at filing.
units_outstandingnumberShares of the class outstanding, as the filer states it.
approx_sale_datestringApproximate date of sale on the notice, YYYY-MM-DD.
exchangestringExchange named on the notice.
brokerstringBroker or market-maker named on the notice.
acquired_howstringHow the seller acquired the shares, free text as filed (Restricted Stock Vesting, Stock Option Exercise, Founders Shares...).
plan_adoption_datestring10b5-1 plan adoption date(s), YYYY-MM-DD, ;-joined when several.
plan_adoption_sourcestringWhich source supplied plan_adoption_date: the Form 144 notice, or the Form 4 footnote ("adopted on ...") when the notice has none.
sold_past_3m_unitsnumberUnits the seller already sold in the past 3 months, as the notice states.
filed_date Known issuestringFiling date YYYY-MM-DD.
accepted_et Known issuestringEDGAR 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 issuestringThe same instant in UTC, ISO-8601 +00:00.
accepted_uk Known issuestringThe same instant in Europe/London time, ISO-8601 with offset (+01:00 in British Summer Time, +00:00 otherwise).
urlstringEDGAR URL of the notice.
amends_accessionstringFor a 144/A: accession of the notice it amends.
statusstringMatch 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_endstringLast 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_bystringAccession of the 144/A that supersedes this notice (status SUPERSEDED).
duplicate_ofstringAccession of the earlier identical notice (status DUPLICATE).
f4_shares_soldnumberShares from matching Form 4 sale lines credited to this notice.
f4_pct_of_144number100 * f4_shares_sold / units_to_sell, 1 decimal.
f4_value_soldnumberUSD value of those credited sale lines (shares x price), 2 decimals.
f4_first_salestringEarliest transaction date among the credited Form 4 lines.
f4_last_salestringLatest transaction date among the credited Form 4 lines.
f4_accessionsstring;-joined accessions of the Form 4 filings credited.
multi_filer_same_saleinteger1 when several filers (e.g. co-trustees) reported the same sale in identical lines and it was credited once.
generated_at_utcstringUTC time the match table was last rebuilt (...Z).

Clusters

GET /v1/clusters · $0.03 per call

FieldTypeMeaning
run_datestringDate the cluster run was made for (YYYY-MM-DD); the end of the window.
generated_at_utcstringUTC time the run was made (...Z).
window_daysintegerLook-back length: window_start is window_end minus this many days (30 now, a current setting).
window_startstringFirst day of the window: window_end minus window_days.
window_endstringLast day of the window (= run_date).
issuer_cikintegerCIK of the issuer.
security_classstringShare class of the buys: Class A, Class B... when the security title names a letter class, otherwise Common.
issuer_namestringIssuer name (latest in the window).
tickerstringTicker 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_insidersintegerNumber of distinct owner groups with at least one counted buy in the window.
n_insiders_min_valueintegerHow many of those insiders bought at least $10,000 each (priced buys, window total).
n_token_insidersintegerInsiders whose priced buys total more than $0 but under $10,000: counted in n_insiders, not in n_insiders_min_value.
token_insidersstringFirst-listed name of each insider whose priced purchases in the window are above zero and under $10,000, sorted and joined with ; .
n_insiders_unpricedintegerInsiders with buys but no usable price (no dollar value).
n_buysintegerNumber 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_priceintegerBuy lines with no usable price: counted in n_buys, excluded from total_value.
total_valuenumberUSD 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_pctnumberLargest single insider's share of the priced dollars, percent, 1 decimal.
first_txnstringEarliest transaction date among the buys.
last_txnstringLatest transaction date among the buys.
insidersstringFirst-listed name of each owner group, sorted and joined with ; .
joint_filersstringOther owner names on a joint filing that were merged into the owner group, sorted and joined with ; .
rolesstringOfficer title where one is present, otherwise the role text, for each owner group, sorted and joined with ; .
ceo_cfointeger1 if any of those titles contains CEO, chief executive, CFO or chief financial (case-insensitive).
identical_price_buysintegerAlways 0 in v1.
n_late_buysintegerBuy lines whose Form 4 was filed more than 2 weekdays (Mon-Fri) after the transaction date.
late_filedinteger1 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_accessionsstringAccessions of the late Form 4s, joined with ; (no space).
sicstringSIC code of the issuer from its EDGAR record; empty text when SEC has none.
sector_sicstringEDGAR's sicDescription for that code; empty text (not NULL) when none.
fund_flaginteger1 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_12mintegerNumber 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_unknownintegerNumber 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_flaginteger1 if at least one insider's buy was a first in 12 months.
n_10b5_1_buys_excludednumberNumber 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_insidersnumberDistinct owner groups behind those plan buys.
cluster_classstringfund if fund_flag = 1, else discretionary.
default_viewinteger1 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

Read the terms and the privacy notice. The same texts are served on the API at /terms and /privacy.