Insider activity

Query insider transactions.

GET/api/v1/ownership/insiders
Domain
Flows & Wallets
Level
Asset identification
MCP tool
ownership_flows_query (task=insiders)

Available data

Returns
Insider transactions and post-transaction holdings
Market coverage
US stocks
What each request returns
View individual insider transactions, filtered by transaction date.

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

Asset identification

Provide at least one of asset_id or query. query also requires market

asset_idstringqueryconditional

Asset identifier for stocks, crypto assets and other asset objects

querystringqueryconditional

Stock or ETF ticker/name; market is required when using query

Market

Required with query; optional with asset_id

marketstringqueryconditional

Required with query; optional when asset_id identifies the subject. US stocks

Filters and pagination

Filter by transaction type, insider relationship, name and transaction date

asset_classstringqueryoptional

Asset class for disambiguation; cannot override the endpoint subject type

transaction_typestringqueryoptional

Exact transaction type; retain spaces and parentheses in enum values

relationstringqueryoptional

Exact insider relationship to the company

insider_namestringqueryoptional

Filter by insider name

fromdatequeryoptional

Inclusive start date: reporting date for institutional rows, trade date for other lists

todatequeryoptional

Inclusive end date; must not precede from

pageintegerqueryoptional

Page number, starting at 1; defaults to 1

page_sizeintegerqueryoptional

Defaults to 50, maximum 100; explicitly set 20 if preferred

Response

request_idstringExamplereq_example

Request trace ID

resolution_statusResolutionStatusExampleresolved

Object resolution status

data_statusDataStatusExampleok

Data status

dataobject

Business data

items[]object[]

Business records

insider_namestringExampleExample insider

Insider name

relationstring | nullExampleOfficer

Insider relationship

transaction_datedateExample2026-10-20

Transaction date

transaction_typestringExampleSell

Transaction type

shares_tradednumber | nullExample2399

Shares involved in the transaction

pricenumber | nullExample339.62

Reported per-share transaction price

shares_held_afternumber | nullExample34795

Shares held after the transaction

metadataobject

Pagination, freshness and limitations

object_refs[]object[]

GateData object references

typeObjectRefTypeExampleasset

Object type

idstringExampleasset_aapl_common_stock

Object ID

paginationobject

Pagination

pageintegerExample1

Current page

page_sizeintegerExample20

Page size

totalintegerExample1

Total matching records

source_refs[]object[]

Source tracking array

ref_idstringExamplesrc_opaque

Source tracking ID

observed_atdatetimeExample2026-10-30T05:00:00Z

Data observation time

updated_atdatetimeExample2026-10-30T05:00:00Z

Data update time (UTC)

limitations[]string[]Examplecoverage_limitation

Additional information

errorobject | null

Error object; null on success

Errors & fallback

200
The request was processed and query results are returned.
400
Missing identity, conflicting parameters, invalid enum/date/range or quarter (YYYY/Qn).
404
Object not found or ambiguous; refine identity.
422
Market or asset type not supported.
503
The requested data is temporarily unavailable.
502
Upstream error without usable cached data.