Lo que devuelve
Mapeo masivo de identificadores de seguridad a través de la API OpenFIGI v3. FIGI (Financial Instrument Global Identifier) es un estándar de identificación abierto y de dominio público.
- Mapear tickers, ISINs, CUSIPs, SEDOLs y IDs de Bloomberg (mezclados en una lista; el tipo se detecta por el formato) a FIGI, FIGI compuesto y FIGI de clase de acción
- Cada resultado tiene nombre, ticker, código de bolsa, tipo de seguridad y sector de mercado
- Los identificadores desconocidos devuelven
found: falsey la razón - O buscar instrumentos por nombre
Solicitud
POST https://api.pushbuild.com/openfigi-mapping/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
identifiers | lista de cadenas | Hasta 500 tickers, ISINs, CUSIPs, SEDOLs o FIGIs, mezclados. El tipo se detecta del formato. |
exchCode | string | Código de intercambio OpenFIGI aplicado a tickers, p. ej. US (todos los intercambios de EE. UU.), LN, JP, GR. Por defecto US. Cadena vacía para cualquier intercambio. Por defecto: "US". |
allMatches | boolean | Devolver cada lista a la que un identificador se mapea (un ISIN puede mapearse a muchos intercambios). Por defecto: solo el primer resultado. Por defecto: false. |
search | string | Buscar instrumentos por nombre o palabras clave en lugar de mapear identificadores, p. ej. apple. |
marketSecDes | string | Filtro de búsqueda opcional, p. ej. Equity, Corp, Govt, Comdty, Index, Curncy. |
maxResults | entero | Solo búsqueda. Por defecto: 100. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
Ejemplo
curl -X POST https://api.pushbuild.com/openfigi-mapping/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"identifiers": ["AAPL", "US5949181045", "037833100"], "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,40 por 1.000 mapeos. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/openfigi-mapping. Agréguelo a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com