Insider transactions

Parameters#

company_idsstringoptional · query

Filter by issuer IDs. May be combined with instrument selectors; filters intersect, except on issuer-level datasets (statements, segments, estimates, earnings, insider transactions), where an instrument selector is read as its company and takes the place of company_ids, so results cover every share class.

instrument_idsstringoptional · query

Filter by stable instrument IDs. IDs and symbols may not be combined.

symbolsstringoptional · query

Convenience lookup for exchange-listed instruments as MIC:TICKER or a bare ticker, which resolves to the exchange listing that ticker; resolves at symbol_at. The MIC and the ticker are case-insensitive, and two spellings of one listing (AAPL and XNAS:AAPL) count as a repeated value. A bare ticker that names no listing as written is also read in the common vendor spellings: with an exchange suffix (RY.TO, SHEL.L, VOD.LSE, BHP.AX), ^GSPC for INDEX:GSPC, and EURUSD=X or EURUSD for FOREX:EUR-USD. A ticker may contain a space (BAC PRL) but not start or end with one. A request in which no symbol resolves returns 404 symbol-not-resolved; otherwise each symbol that does not resolve, or resolves to a listing with no rows for the request (no-data), is an entry of meta.errors. IDs and symbols may not be combined.

symbol_atstringoptional · query

Resolve symbols as they were assigned at the end of this UTC date (YYYY-MM-DD); defaults to as_of. Only listings the security master holds resolve: it was built in September 2026 and records delistings from then on, so most issuers delisted earlier, such as TWTR or SIVB, resolve at no date. Only valid with symbols.

fromstringoptional · query

Inclusive lower bound on transaction_date.

tostringoptional · query

Inclusive upper bound on transaction_date; must be on or after from, so from equal to to selects one day.

sidestringoptional · query

Transaction direction.

acquisitiondisposition

as_ofstringoptional · query

Knowledge cutoff as a UTC date (YYYY-MM-DD): the response reflects what was known by the end of that day. Defaults to now; cannot be in the future. A date from before the dataset's knowledge history returns 422 point-in-time-unavailable naming the earliest one, which GET /v1/datasets lists as earliest_as_of.

known_fromstringoptional · query

First UTC date (YYYY-MM-DD, inclusive) on which a revision became known.

known_tostringoptional · query

Last UTC date (YYYY-MM-DD, inclusive) on which a revision became known; on or after known_from.

orderstringoptional · query

Direction on transaction_date; ties use ID ascending.

ascdesc

Default: asc

limitintegeroptional · query

Maximum records per page.Default: 100

cursorstringoptional · query

Opaque cursor, expires after one hour; binds filters, order, resolved as_of, account/key and entitlement. Repeat the original query unchanged.

formatstringoptional · query

Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.

jsoncsv

Response fields#

Returns data as an array of records. All example values are illustrative.

idstring

Record identifier, stable across revisions.

company_idstring

Opaque stable public identifier; never an internal database key.

instrument_idstring · null

Listing the disclosed security trades as, when security_title identifies it: the company's one listed common stock for plain common or ordinary shares, or the listed share class the title names. Null for any other security (preferred shares, notes, awards, an unlisted class) and when several listed classes could be meant; company_id always names the issuer.

security_titlestring · null

Security title supplied by the disclosure.

owner_idstring

Stable owner ID.

owner_namestring

Owner name.

relationshipstring · null

Issuer relationship.

transaction_datestring

transaction date

filed_atstring · null

Instant the disclosure was accepted. Not available from the connected source, which gives the filing date only: always null, use filed_on.

filed_onstring · null

Date the disclosure was filed.

transaction_codestring

Source transaction code.

sidestring

Whether shares were acquired or disposed; does not imply open-market trading.

acquisitiondisposition

sharesstring

Transaction shares.

priceobject

price

shares_afterstring · null

Shares after transaction.

ownership_typestring

Ownership form. The connected source does not state it: always unknown.

directindirectunknown

filing_idstring · null

SEC accession number of the Form 4 or 5 that disclosed the transaction. Ownership forms are not listed by /v1/filings, which carries periodic and current reports.

Response metadata#

Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.

When something goes wrong#

An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.

Plans#

Requires insider-transactions.read. Access, recency and history depth come from the plan definitions the API enforces.

History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans