Développeurs

Tout pour intégrer des prix en temps réel et historiques : une référence interactive, des SDK Python et JavaScript, la spécification OpenAPI et une collection Postman.

Démarrage rapide

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"]));

Les clients sont des fichiers uniques que vous gardez dans votre projet : rien à installer depuis un registre de paquets et aucun code tiers à qui faire confiance. Placez le fichier à côté de votre script, ou dans n’importe quel dossier de votre chemin d’import.

marketapi.py marketapi.mjs Spécification OpenAPI 3.1 · Collection Postman · Guides · Journal des modifications · Oracle (smart contracts)

Vous développez un smart contract ?

L’oracle de prix on-chain fournit à votre contrat les mêmes prix sous forme de rapports signés qu’il peut vérifier on-chain : GET https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10, puis submit(report, signature) et getPriceNoOlderThan(feedId, maxAge). Exemples Solidity et ethers v6, adresses des contrats et ID de flux dans la documentation de l’oracle.

Référence interactive

Votre clé API (conservée uniquement dans cet onglet, jamais enregistrée)

General

GET /v1/status Service status

Aucune clé API nécessaire · Facturation : free

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

Aucune clé API nécessaire · Facturation : free

GET /v1/postman.json Postman collection

Aucune clé API nécessaire · Facturation : free

GET /v1/account Your balance, plan and limits

Toute clé API valide · Facturation : free

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

Toute clé API valide · Facturation : 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

Portée read:symbols · Facturation : 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

Portée read:metadata · Facturation : free

canonical *

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

Portée read:metadata · Facturation : 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

Portée read:latest · Facturation : free

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

GET /v1/prices/latest Latest bid/ask

Portée read:latest · Facturation : 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

Portée read:ohlcv · Facturation : 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

Portée read:history · Facturation : 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

Portée read:metadata · Facturation : 25 credits per call

symbol * One symbol. timeframe *

Free tier

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

Aucune clé API nécessaire · Facturation : 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

Aucune clé API nécessaire · Facturation : free (fair-use limits)

q

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

Aucune clé API nécessaire · Facturation : 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)

Aucune clé API nécessaire · Facturation : free

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

Aucune clé API nécessaire · Facturation : free

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

Portée read:oracle · Facturation : credits per signed report

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

Erreurs

Les erreurs utilisent les détails de problème RFC 9457 : {"type", "title", "status", "code", "detail", "request_id"}. Indiquez le request_id en contactant l’assistance.

HTTP code Signification Que faire

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	code	Signification	Que faire
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.