StockDrifts LogoStockDrifts

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.

1

Get your API key

API and MCP access come with Ultra. Create a key in Settings, API keys.

Get your API key
2

Connect your AI

Add the MCP server to Claude, ChatGPT or your own agent. Clients that sign in need no key.

3

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_….

Response
1curl "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).

Response
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:

Response
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.