StockDrifts

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

Inicio rápido

La API de datos de StockDrifts es solo HTTPS con JSON de entrada y salida. Cubre datos que StockDrifts posee o deriva de registros públicos: presentaciones de información privilegiada de Corea, informes de participación accionaria según la regla del 5% de Japón, tenencias 13F de EE. UU. y KPIs normalizados de empresas. Cada solicitud se autentica con un token de portador.

URL base

https://api2.stockdrifts.io

Autenticación

Envía tu clave como token de portador en cada solicitud. Las claves se emiten desde el panel de control y tienen el formato sd_live_….

Respuesta

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

¿Quieres tu propia clave de API?

Reserva una demostración de 30 minutos y te ayudaremos a configurarla, o escribe a hk@stockdrifts.io.

Paginación

Los endpoints marcados como paginados aceptan ?page=&limit= (page está indexado desde 0). Una página más corta que limit significa que no hay más filas. Cada lista devuelve un arreglo simple: sin envoltorio, sin recuento total.

Límites de velocidad

Se aplican por clave en ventanas fijas de un minuto. Las respuestas incluyen X-RateLimit-Limit, -Remaining y -Reset; un error 429 añade Retry-After.

Campos y moneda

Las respuestas son JSON en snake_case. Los campos de valor llevan el sufijo de su moneda (value_usd, value_krw, value_jpy), por lo que nada se convierte de divisa silenciosamente.

Períodos

Los valores de period de 13F son fechas de fin de trimestre en formato ISO (2026-03-31), no 2026-Q1. Omítelo para obtener el trimestre más reciente disponible.

Errores

Cada error usa una sola forma, con un hint opcional. El code se corresponde con el estado HTTP: bad_request (400), unauthorized (401), forbidden (403), not_found (404), validation_error (422), rate_limited (429), upstream_error (502) y internal_error (500, que incluye un request_id para citar al reportarlo).

Respuesta

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	}

Los parámetros fuera de rango fallan de la misma manera, indicando el campo infractor:

Respuesta

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