Desarrolladores

Todo para integrar precios en tiempo real e históricos: una referencia interactiva, SDK para Python y JavaScript, la especificación OpenAPI y una colección de Postman.

Inicio rápido

Python

# one file, standard library only (Python 3.9+)
curl -O https://app.marketapi.app/sdk/marketapi.py
pip install websockets          # only if you use the live stream

from marketapi import MarketAPI
api = MarketAPI("YOUR_API_KEY")
print(api.latest(["EURUSD", "XAUUSD"]))

JavaScript

// one ES module, no dependencies (Node 18+ and browsers)
curl -O https://app.marketapi.app/sdk/marketapi.mjs
npm install ws                  # only for the live stream in Node.js

import { MarketAPI } from "./marketapi.mjs";
const api = new MarketAPI({ apiKey: process.env.API_KEY });
console.log(await api.latest(["EURUSD"]));

Los clientes son archivos únicos que guardas en tu proyecto, así que no hay nada que instalar desde un registro de paquetes ni código de terceros en el que confiar. Pon el archivo junto a tu script o en cualquier carpeta de tu ruta de importación.

marketapi.py marketapi.mjs Especificación OpenAPI 3.1 · Colección de Postman · Guías · Registro de cambios · Oráculo (contratos inteligentes)

¿Estás creando un contrato inteligente?

El oráculo de precios on-chain da a tu contrato los mismos precios como informes firmados que puede verificar on-chain: GET https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10, luego submit(report, signature) y getPriceNoOlderThan(feedId, maxAge). Los ejemplos en Solidity y ethers v6, las direcciones de los contratos y los ID de fuentes están en la documentación del oráculo.

Referencia interactiva

Tu clave API (solo se guarda en esta pestaña, nunca se almacena)

General

GET /v1/status Service status

No necesita clave API · Facturación: free

GET /v1/openapi.json This API description (OpenAPI 3.1)

No necesita clave API · Facturación: free

GET /v1/postman.json Postman collection

No necesita clave API · Facturación: free

GET /v1/account Your balance, plan and limits

Cualquier clave API válida · Facturación: free

GET /v1/cost-preview Credits a request would cost

Cualquier clave API válida · Facturación: free

endpoint * symbol One symbol. from Start (UTC), ISO 8601 or epoch milliseconds. to End (UTC), exclusive.

Symbols

GET /v1/symbols Search the symbol list

Ámbito read:symbols · Facturación: free

q asset_class limit Rows per page (default 1000). cursor Value of next_cursor from the previous page.

GET /v1/symbols/{canonical} One symbol's specification

Ámbito read:metadata · Facturación: free

canonical *

GET /v1/symbols/{canonical}/properties/history Specification change history

Ámbito read:metadata · Facturación: free

canonical * limit Rows per page (default 1000). cursor Value of next_cursor from the previous page.

Prices

GET /v1/market-status Market status per symbol

Ámbito read:latest · Facturación: free

symbols * Comma-separated symbols, e.g. EURUSD,XAUUSD (up to 100).

GET /v1/prices/latest Latest bid/ask

Ámbito read:latest · Facturación: 1 credit per symbol returned

symbols * Comma-separated symbols, e.g. EURUSD,XAUUSD (up to 100). require_live Only LIVE prices; others are listed under not_live and not billed.

History

GET /v1/bars Historical OHLC candles

Ámbito read:ohlcv · Facturación: credits per block of rows

symbol * One symbol. timeframe * from * Start (UTC), ISO 8601 or epoch milliseconds. to * End (UTC), exclusive. limit Rows per page (default 1000). cursor Value of next_cursor from the previous page.

GET /v1/ticks Historical ticks

Ámbito read:history · Facturación: credits per block of rows

symbol * One symbol. from * Start (UTC), ISO 8601 or epoch milliseconds. to * End (UTC), exclusive. limit Rows per page (default 1000). cursor Value of next_cursor from the previous page.

Analytics

GET /v1/patterns/stats Pattern strategy statistics

Ámbito read:metadata · Facturación: 25 credits per call

symbol * One symbol. timeframe *

Free tier

GET /v1/free/prices/latest Delayed prices, no key

No necesita clave API · Facturación: free (fair-use limits)

symbols * Comma-separated symbols, e.g. EURUSD,XAUUSD (up to 100).

GET /v1/free/symbols Free-tier symbol list, no key

No necesita clave API · Facturación: free (fair-use limits)

q

GET /v1/free/market-status Market status, no key

No necesita clave API · Facturación: free (fair-use limits)

symbols * Comma-separated symbols, e.g. EURUSD,XAUUSD (up to 100).

Oracle

GET /v1/oracle/feeds Oracle feeds, networks and signer (when the oracle is enabled)

No necesita clave API · Facturación: free

GET /v1/oracle/catalog Oracle feeds by network: asset name, category, contract, decimals (when enabled)

No necesita clave API · Facturación: free

GET /v1/oracle/report Signed EIP-712 price reports (when the oracle is enabled)

Ámbito read:oracle · Facturación: credits per signed report

symbols * Comma-separated symbols, e.g. EURUSD,XAUUSD (up to 100). chain_id *

Errores

Los errores usan detalles de problema RFC 9457: {"type", "title", "status", "code", "detail", "request_id"}. Indica el request_id al contactar con soporte.

HTTP código Significado Qué hacer

400 invalid_parameter A parameter is missing or malformed. Check the parameter named in detail.

400 too_many_symbols Too many symbols in one request. Split the request (up to 100 symbols).

400 range_too_large The time range is too long for this endpoint. Request shorter ranges and page.

400 credentials_in_query The API key was sent in the URL. Send it in the Authorization header.

401 unauthenticated No or an invalid API key. Send Authorization: Bearer <key>.

401 key_revoked The API key was revoked. Create a new key in the dashboard.

401 key_expired The API key has expired. Create a new key or extend it.

402 insufficient_balance No credits left. Top up or choose a plan.

402 plan_credits_used_up The plan's credits for this month are used up (your balance is never used while a plan runs). Add credits to the month or upgrade on the billing page.

402 plan_ended The API plan has ended; the balance is not used until you choose. Renew, pick a plan, or choose pay as you go on the billing page.

403 insufficient_scope The key lacks the scope this endpoint needs. Create a key with that scope.

403 ip_not_allowed The request came from an IP the key does not allow. Update the key's IP list.

403 account_inactive The account is suspended or not verified. Verify your email or contact support.

403 sandbox_not_billable Test keys cannot call billable endpoints. Use a live key.

404 not_found Resource not available. Check the URL; some features may be switched off.

404 unknown_symbol The symbol does not exist. Search /symbols or the ticker list.

404 free_tier_disabled The free tier is switched off. Use an API key.

405 method_not_allowed Wrong HTTP method. Use GET.

409 idempotency_mismatch Same Idempotency-Key reused with different parameters. Use a new key.

409 idempotency_key_used The Idempotency-Key was used and its answer is no longer kept (24 h, 2 MB). Send a new key for current data.

429 rate_limited Too many requests per minute or hour. Wait for Retry-After; batch symbols.

429 too_many_concurrent_requests Too many requests in parallel. Limit concurrency.

429 daily_limit Free-tier daily limit reached. Retry tomorrow or use an API key.

503 oracle_unavailable The oracle signing service is temporarily unavailable. Retry with back-off.

503 free_tier_unavailable The free tier is temporarily unavailable. Retry later.

503 free_tier_busy The free tier is busy. Retry later or use an API key.

HTTP	código	Significado	Qué hacer
400	`invalid_parameter`	A parameter is missing or malformed.	Check the parameter named in detail.
400	`too_many_symbols`	Too many symbols in one request.	Split the request (up to 100 symbols).
400	`range_too_large`	The time range is too long for this endpoint.	Request shorter ranges and page.
400	`credentials_in_query`	The API key was sent in the URL.	Send it in the Authorization header.
401	`unauthenticated`	No or an invalid API key.	Send Authorization: Bearer <key>.
401	`key_revoked`	The API key was revoked.	Create a new key in the dashboard.
401	`key_expired`	The API key has expired.	Create a new key or extend it.
402	`insufficient_balance`	No credits left.	Top up or choose a plan.
402	`plan_credits_used_up`	The plan's credits for this month are used up (your balance is never used while a plan runs).	Add credits to the month or upgrade on the billing page.
402	`plan_ended`	The API plan has ended; the balance is not used until you choose.	Renew, pick a plan, or choose pay as you go on the billing page.
403	`insufficient_scope`	The key lacks the scope this endpoint needs.	Create a key with that scope.
403	`ip_not_allowed`	The request came from an IP the key does not allow.	Update the key's IP list.
403	`account_inactive`	The account is suspended or not verified.	Verify your email or contact support.
403	`sandbox_not_billable`	Test keys cannot call billable endpoints.	Use a live key.
404	`not_found`	Resource not available.	Check the URL; some features may be switched off.
404	`unknown_symbol`	The symbol does not exist.	Search /symbols or the ticker list.
404	`free_tier_disabled`	The free tier is switched off.	Use an API key.
405	`method_not_allowed`	Wrong HTTP method.	Use GET.
409	`idempotency_mismatch`	Same Idempotency-Key reused with different parameters.	Use a new key.
409	`idempotency_key_used`	The Idempotency-Key was used and its answer is no longer kept (24 h, 2 MB).	Send a new key for current data.
429	`rate_limited`	Too many requests per minute or hour.	Wait for Retry-After; batch symbols.
429	`too_many_concurrent_requests`	Too many requests in parallel.	Limit concurrency.
429	`daily_limit`	Free-tier daily limit reached.	Retry tomorrow or use an API key.
503	`oracle_unavailable`	The oracle signing service is temporarily unavailable.	Retry with back-off.
503	`free_tier_unavailable`	The free tier is temporarily unavailable.	Retry later.
503	`free_tier_busy`	The free tier is busy.	Retry later or use an API key.