How do I get started with the insider screener API?

The insider screener API gives you programmatic access to structured insider transaction data from global markets. Depending on your plan, you can use it to retrieve transactions, issuers, insiders and market feeds—or build research workflows with ranked screeners and performance data.

Useful links

• Interactive API documentation (Swagger): explore every endpoint, review request and response formats, and send test requests from your browser.
• OpenAPI schema: download the machine-readable specification for Postman, Insomnia or client generation tools.
• API pricing: compare endpoint access, included credits, data scope and request limits.
• API Access: generate or rotate your API key, review usage and request history, and top up credits.

The base URL for all version 1 requests is:

https://www.insiderscreener.com/api/v1/

Use the www hostname exactly as shown.

1. Choose an API plan

All API plans include access to core insider transaction and market data. API Research also includes the screener and research endpoints used for ranked signals, insider performance and other advanced workflows.

Visit API pricing to compare the current plans, monthly credit allowances, rate limits and historical data scope.

2. Generate your API key

After activating API access, sign in and open Account → API Access. Select Generate key, then copy the secret and store it securely.

The full secret is shown only once. If you lose it, rotate the key from the same page and update any integration that used the previous key.

3. Authenticate your requests

Send your API key in the X-API-Key header:

X-API-Key: YOUR_API_KEY

Do not add a prefix to the key. The API does not support Authorization: Bearer YOUR_API_KEY.

If you use the interactive Swagger documentation, select Authorize, paste the key without a prefix, and select Authorize again.

4. Make your first request

This example returns recent US insider transactions:

curl --request GET \
  --url 'https://www.insiderscreener.com/api/v1/data/transactions/?market=US&page_size=5' \
  --header 'X-API-Key: YOUR_API_KEY'

List responses contain a data array and a pagination object. For cursor-paginated endpoints, follow the next URL returned in the response instead of constructing the next page yourself.

The API documentation includes the available filters, example responses and code samples for each endpoint.

Credits and rate limits

API requests use credits according to the endpoint family and market scope. For example, a single-market core data request can cost less than a global request. Some list endpoints are also billed according to the number of rows returned.

Your current allowance, remaining credits, request rate, reset date and recent request history are available on the API Access page. The API pricing page lists the current credit costs by endpoint family.

If you exceed a request-rate or credit limit, the API returns HTTP 429. Slow down and retry rate-limited requests after a delay. If you have exhausted your billing-period credits, wait for the next reset, add credits or change plans.

Common errors

• 401 Unauthorized: the API key is missing, invalid, inactive or sent using an unsupported authentication format.
• 403 Forbidden: your API plan does not include the requested endpoint.
• 429 Too Many Requests: you have exceeded a request-rate or credit limit.

Keep your API key secure

Treat your API key like a password. Store it in an environment variable or secret manager, never commit it to source control, and do not expose it in browser-side JavaScript or public repositories. Rotate the key immediately if you believe it has been disclosed.

Need help choosing an endpoint or planning an integration? Contact API support.