StockDrifts

npx add-mcp 'https://mcp.stockdrifts.io/mcp/'

Início rápido

A API de Dados do StockDrifts é exclusivamente HTTPS com JSON na entrada e na saída. Ela cobre dados que o StockDrifts possui ou deriva de registros públicos — declarações de insider trading coreanas, relatórios de participação acionária japonesa (regra dos 5%), participações 13F dos EUA e KPIs normalizados de empresas. Cada requisição é autenticada com um token bearer.

URL base

https://api2.stockdrifts.io

Autenticar

Envie sua chave como token bearer em cada requisição. As chaves são emitidas pelo painel e têm o formato sd_live_….

Resposta

1	curl "https://api2.stockdrifts.io/v1/kr/insiders/top-buys?days=30" \
2	-H "Authorization: Bearer sd_live_..."

Quer sua própria chave de API?

Agende uma demonstração de 30 minutos e nós o ajudaremos a configurar, ou envie um e-mail para hk@stockdrifts.io.

Paginação

Endpoints marcados como paginados aceitam ?page=&limit= (page é indexado a partir de 0). Uma página mais curta que limit significa que não há mais linhas. Cada lista retorna um array simples — sem envelope, sem contagem total.

Limites de taxa

Aplicados por chave em janelas fixas de um minuto. As respostas incluem X-RateLimit-Limit, -Remaining e -Reset; um erro 429 adiciona Retry-After.

Campos e moeda

As respostas são JSON em snake_case. Os campos de valor têm sufixo com a moeda (value_usd, value_krw, value_jpy), portanto nada é convertido de câmbio silenciosamente.

Períodos

Os valores de period do 13F são datas de fim de trimestre no formato ISO (2026-03-31), não 2026-Q1. Omita esse campo para obter o trimestre mais recente disponível.

Erros

Todo erro usa um único formato, com um hint opcional. O code corresponde ao status HTTP: bad_request (400), unauthorized (401), forbidden (403), not_found (404), validation_error (422), rate_limited (429), upstream_error (502) e internal_error (500, que inclui um request_id para citar ao relatar o problema).

Resposta

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	}

Parâmetros fora do intervalo falham da mesma forma, indicando o campo problemático:

Resposta

1	{
2	"error": {
3	"code": "validation_error",
4	"message": "limit: Input should be less than or equal to 500"
5	}
6	}