{"openapi":"3.1.0","info":{"title":"InsiderRadar read API","version":"1","summary":"SEC Form 4 insider transactions as JSON.","description":"The read API of InsiderRadar: the SEC Form 4 rows of the register on https://www.insiderradar.nl/transactions, with the same filters, page by page. Facts from the filings, with a link to the source filing on every row; no scores, percentiles or signals. A key comes with a subscription and is made on the account page. Limits: 10000 requests and 100 MB per calendar day (UTC) over all keys of an account, and 60 requests per minute. The European registers, Congress, 13F and lobbying are read through the MCP server at https://www.insiderradar.nl/api/mcp, not through this API.","termsOfService":"https://www.insiderradar.nl/terms","contact":{"name":"InsiderRadar","email":"support@insiderradar.nl","url":"https://www.insiderradar.nl/contact"}},"externalDocs":{"description":"The API in plain language","url":"https://www.insiderradar.nl/guides/insider-trading-api"},"servers":[{"url":"https://www.insiderradar.nl"}],"tags":[{"name":"form4","description":"SEC Form 4 — Statement of Changes in Beneficial Ownership, U.S. Securities and Exchange Commission (EDGAR)."}],"paths":{"/api/v1/form4/transactions":{"get":{"operationId":"listForm4Transactions","tags":["form4"],"summary":"List SEC Form 4 insider transactions","description":"Form 4 rows in ascending order of record_key. Pass page.next_after as `after` to get the next page. An unknown parameter is a 400, not a silent fallback. Every delivered answer counts against the daily limits.","security":[{"apiKey":[]}],"parameters":[{"name":"q","in":"query","description":"Part of the company name (case-insensitive).","schema":{"type":"string"}},{"name":"country","in":"query","description":"Only US is available; any other value is a 400 (country_not_available).","schema":{"type":"string","enum":["US"],"default":"US"}},{"name":"category","in":"query","description":"buys (open-market purchases, the default), all, or one transaction category.","schema":{"type":"string","enum":["buys","all","open_market_buy","open_market_sell","option_exercise","award_no_signal","admin_no_signal","no_signal","pledge","gift","conversion","disposition_to_issuer","tender_change_of_control","other_disclosed"],"default":"buys"}},{"name":"role","in":"query","description":"Part of the filer's role, such as Director or CEO (case-insensitive).","schema":{"type":"string"}},{"name":"min","in":"query","description":"Minimum transaction value in dollars, such as 5000 or 2500.50.","schema":{"type":"string","pattern":"^(\\d+|\\d{1,3}(,\\d{3})+)(\\.\\d+)?$"}},{"name":"from","in":"query","description":"Earliest filing date (notification_date), YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Latest filing date (notification_date), YYYY-MM-DD.","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","description":"Rows per page, 1 to 1000.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"name":"after","in":"query","description":"Cursor: the record_key after which this page starts, as returned in page.next_after.","schema":{"type":"string","pattern":"^us:[0-9A-Za-z._:-]{1,200}$"}}],"responses":{"200":{"description":"One page of Form 4 rows.","headers":{"x-ratelimit-limit":{"description":"Requests allowed per calendar day (UTC), over all keys of the account.","schema":{"type":"integer","const":10000}},"x-ratelimit-remaining":{"description":"Requests left today (UTC) after this one.","schema":{"type":"integer","minimum":0}},"x-ratelimit-reset":{"description":"When the daily counters reset (the next midnight UTC).","schema":{"type":"string","format":"date-time"}},"x-bytes-limit":{"description":"Bytes of answers allowed per calendar day (UTC).","schema":{"type":"integer","const":100000000}},"x-bytes-used":{"description":"Bytes of answers used today (UTC), this one included.","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Form4Page"}}}},"400":{"description":"The query could not be read. Nothing was read or counted. Error codes: unknown_parameter, country_not_available, invalid_date, invalid_limit, invalid_category, invalid_min, invalid_cursor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"No key in the Authorization header, or a key that does not exist. Error codes: missing_key, invalid_key.","headers":{"www-authenticate":{"description":"Bearer realm=\"insiderradar\", with error=\"invalid_token\" for a key that does not exist.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key was revoked, or its account has no active subscription. Error codes: key_revoked, subscription_required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"A limit was reached. Nothing was read or counted. Error codes: daily_request_limit, daily_byte_limit, rate_limit.","headers":{"retry-after":{"description":"Seconds until the limit opens again.","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Temporarily unavailable; try again. Error codes: api_not_enabled, gate_unavailable, register_unavailable, ledger_unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/status":{"get":{"operationId":"getApiStatus","tags":["form4"],"summary":"Whether the Form 4 data is up to date","description":"The state of the SEC Form 4 source: newest filing date, last successful run and its state. Readable without a key, and not counted.","security":[],"responses":{"200":{"description":"The state of the Form 4 source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Status"}}}},"503":{"description":"The status could not be read just now. Error codes: status_unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"irk_ followed by 43 base64url characters","description":"Send the key as `Authorization: Bearer irk_…`. Never in the query string. Keys are made and revoked on the account page."}},"schemas":{"Source":{"type":"object","required":["name","publisher","url","terms"],"properties":{"name":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"terms":{"type":"string"}}},"Form4Row":{"type":"object","required":["record_key","notification_date","transaction_date","issuer_name","issuer_symbol","insider_name","insider_role","category","quantity","price","transaction_value","currency","source_url"],"additionalProperties":false,"properties":{"record_key":{"type":"string","description":"Stable key of this row: us:<SEC accession number>:<table>:<line>. Use it as the cursor in `after`."},"notification_date":{"type":"string","format":"date","description":"The day the filing was made at the SEC."},"transaction_date":{"type":["string","null"],"format":"date","description":"The day of the trade, as filed."},"issuer_name":{"type":"string","description":"The company whose shares were traded."},"issuer_symbol":{"type":["string","null"],"description":"The ticker as filed."},"insider_name":{"type":"string","description":"The person or entity that filed."},"insider_role":{"type":["string","null"],"description":"The filer's relationship to the company, as filed."},"category":{"type":"string","enum":["open_market_buy","open_market_sell","option_exercise","award_no_signal","admin_no_signal","no_signal","pledge","gift","conversion","disposition_to_issuer","tender_change_of_control","other_disclosed"],"description":"The kind of transaction, as classified from the Form 4 transaction code."},"quantity":{"type":["number","null"],"description":"Number of shares."},"price":{"type":["number","null"],"description":"Price per share."},"transaction_value":{"type":["number","null"],"description":"Quantity times price."},"currency":{"type":["string","null"],"description":"Currency of price and value."},"source_url":{"type":["string","null"],"format":"uri","description":"The filing's index page at the SEC."}}},"Form4Page":{"type":"object","required":["api_version","source","query","data","page"],"properties":{"api_version":{"type":"string","const":"1"},"source":{"$ref":"#/components/schemas/Source"},"query":{"type":"object","description":"The filters that applied, defaults included.","properties":{"country":{"type":"string","const":"US"},"category":{"type":"string"},"q":{"type":["string","null"]},"role":{"type":["string","null"]},"min":{"type":["number","null"]},"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"},"limit":{"type":"integer"},"after":{"type":["string","null"]}}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Form4Row"}},"page":{"type":"object","required":["returned","has_more","next_after"],"properties":{"returned":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"],"description":"Pass as `after` for the next page; null on the last page."}}}}},"Status":{"type":"object","required":["api_version","source","read_at","sources"],"properties":{"api_version":{"type":"string","const":"1"},"source":{"$ref":"#/components/schemas/Source"},"read_at":{"type":"string","format":"date-time"},"sources":{"type":"array","maxItems":1,"items":{"type":"object","description":"One row per source; today only the SEC (EDGAR) Form 4 source.","properties":{"source":{"type":"string"},"country":{"type":"string"},"newest_item_date":{"type":["string","null"],"format":"date"},"last_success_at":{"type":["string","null"],"format":"date-time"},"state":{"type":"string"}}}}}},"Error":{"type":"object","required":["api_version","error"],"properties":{"api_version":{"type":"string","const":"1"},"error":{"type":"object","required":["code","message","docs"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"docs":{"type":"string","description":"Path of the documentation on this site."}}}}}}}}