Getting started
StockDrifts API Documentation
Smart-money data for your code and your AI: 13F funds, insiders in Korea and Japan, company KPIs and earnings calls, over one REST API and one MCP server.
Get your API key
API and MCP access come with Ultra. Create a key in Settings, API keys.
Get your API keyConnect your AI
Add the MCP server to Claude, ChatGPT or your own agent. Clients that sign in need no key.
Make a request
Call any endpoint with your key as a bearer token. Each page has a live example.
Use StockDrifts in
Claude and ChatGPT connect with a sign-in, no key to copy. The setup prompt lets the agent you already use install StockDrifts for you.
Key features
- 13F funds with buy prices: what 10,000+ filers hold, what they changed each quarter, and the estimated price they paid.
- Korea and Japan in English: insider trades from Korea and 5% shareholder reports from Japan, with names and values you can read.
- Earnings-call search: ranked claims from management and analysts, with the speaker, fiscal quarter and call date.
- Company KPIs: segment and operating metrics, normalized across quarters.
- One account, two ways in: the REST API and the MCP server share the same key, plan and limits.
- Built for agents: ranked answers instead of paginated dumps, and errors that name the field and suggest a fix.
Base URL and authentication
Base URL
https://api2.stockdrifts.io
HTTPS only, JSON out. Pass your key as a bearer token on every request. Keys look like sd_live_….
| 1 | curl "https://api2.stockdrifts.io/v1/kr/insiders/top-buys?days=30" \ |
| 2 | -H "Authorization: Bearer sd_live_..." |
No pagination
The API answers questions; it doesn't export datasets. Lists return a ranked slice with no page or offset (sending one is a 400): up to 50 rows across the market (last 365 days), 100 for one company or fund (3 years), 20 for search. When a screen reports truncated, narrow the filters. For bulk data, see the dataset licences.
Rate limits
Per user, shared by all your keys and sign-ins: 120 requests a minute, plus a daily budget of requests and data (earnings-call search has its own: 200 a day). Budgets reset at 00:00 UTC. Responses carry X-RateLimit-* and X-Daily-*-Remaining headers; a 429 adds Retry-After.
Fields & currency
Responses are snake_case JSON. Value fields are suffixed with their currency (value_usd, value_krw, value_jpy), so nothing is silently FX-converted.
Periods
13F period values are ISO quarter-end dates (2026-03-31), not 2026-Q1. Omit it to get the latest quarter on file.
Errors
Every error uses one shape, with an optional hint. The code maps to the HTTP status: bad_request (400), unauthorized (401), forbidden (403), not_found (404), validation_error (422), rate_limited (429), upstream_error (502), and internal_error (500, which carries a request_id to quote when reporting it).
| 1 | { |
| 2 | "error": { |
| 3 | "code": "forbidden", |
| 4 | "message": "Your plan does not include the 'holdings' endpoints", |
| 5 | "hint": "See stockdrifts.io/pricing for plans that include it." |
| 6 | } |
| 7 | } |
Out-of-range parameters fail the same way, naming the offending field:
| 1 | { |
| 2 | "error": { |
| 3 | "code": "validation_error", |
| 4 | "message": "limit: Input should be less than or equal to 500" |
| 5 | } |
| 6 | } |
Want your own API key?
Request a 30-minute demo and we'll get you set up, or email hk@stockdrifts.io.