Skip to main content
GET
/
v1
/
insider-trades
List insider trades
curl --request GET \
  --url https://api.ivory.finance/v1/insider-trades \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": 123,
    "accession_number": "<string>",
    "form_type": "<string>",
    "filed_at": "2023-11-07T05:31:56Z",
    "period_of_report": "2023-12-25",
    "cik": "<string>",
    "ticker": "<string>",
    "issuer_cik": "<string>",
    "issuer_name": "<string>",
    "issuer_trading_symbol": "<string>",
    "owner_cik": "<string>",
    "owner_name": "<string>",
    "is_director": true,
    "is_officer": true,
    "is_ten_percent_owner": true,
    "is_other": true,
    "officer_title": "<string>",
    "security_title": "<string>",
    "transaction_date": "2023-12-25",
    "transaction_code": "<string>",
    "transaction_form_type": "<string>",
    "equity_swap_involved": true,
    "transaction_shares": 123,
    "transaction_price_per_share": 123,
    "transaction_total_value": 123,
    "acquired_disposed_code": "<string>",
    "shares_owned_after": 123,
    "is_derivative": true,
    "conversion_exercise_price": 123,
    "exercise_date": "2023-12-25",
    "expiration_date": "2023-12-25",
    "underlying_security_title": "<string>",
    "underlying_security_shares": 123,
    "direct_or_indirect": "<string>",
    "nature_of_ownership": "<string>",
    "created_at": "2023-11-07T05:31:56Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

​
Transaction Codes

CodeMeaning
POpen-market purchase
SOpen-market sale
AGrant / award (e.g. RSUs, options)
DDisposition to the company (e.g. tax withholding)
FPayment of exercise price or tax liability using securities
GGift
MExercise or conversion of derivative security
XExercise of in-the-money or at-the-money derivative (expired)

​
Acquired / Disposed Code

A = acquired (added to position), D = disposed (removed from position).

​
Filtering Tips

  • Use transaction_code=S + is_derivative=false to isolate open-market sales of common stock.
  • Combine from_date / to_date with a ticker to detect insider activity around earnings calls or material events.
  • is_derivative=true returns options, warrants, and convertible instruments.

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
ticker
string
required

Issuer ticker symbol (case-insensitive), e.g. AAPL

​
owner_name
string | null

Partial match on owner/filer name

​
transaction_code
string | null

Transaction code, e.g. S (sale), P (purchase), A (award)

​
is_derivative
boolean | null

Filter to derivative (options/warrants) or non-derivative transactions

​
from_date
string<date> | null

Earliest transaction date (YYYY-MM-DD)

​
to_date
string<date> | null

Latest transaction date (YYYY-MM-DD)

​
limit
integer
default:100
Required range: 1 <= x <= 1000
​
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

​
id
integer | null
​
accession_number
string | null
​
form_type
string | null
​
filed_at
string<date-time> | null
​
period_of_report
string<date> | null
​
cik
string | null
​
ticker
string | null
​
issuer_cik
string | null
​
issuer_name
string | null
​
issuer_trading_symbol
string | null
​
owner_cik
string | null
​
owner_name
string | null
​
is_director
boolean | null
​
is_officer
boolean | null
​
is_ten_percent_owner
boolean | null
​
is_other
boolean | null
​
officer_title
string | null
​
security_title
string | null
​
transaction_date
string<date> | null
​
transaction_code
string | null
​
transaction_form_type
string | null
​
equity_swap_involved
boolean | null
​
transaction_shares
number | null
​
transaction_price_per_share
number | null
​
transaction_total_value
number | null
​
acquired_disposed_code
string | null
​
shares_owned_after
number | null
​
is_derivative
boolean | null
​
conversion_exercise_price
number | null
​
exercise_date
string<date> | null
​
expiration_date
string<date> | null
​
underlying_security_title
string | null
​
underlying_security_shares
number | null
​
direct_or_indirect
string | null
​
nature_of_ownership
string | null
​
created_at
string<date-time> | null