Démarrage rapide de l’API

Prix du crédit : 0.001 $ (1000 crédits gratuits à l’inscription). URL de base https://api.marketapi.app/v1. Envoyez votre clé dans l’en-tête Authorization. Les clés dans les URL sont refusées.

curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/bars?symbol=EURUSD&timeframe=M1&from=2026-09-01T00:00:00Z&to=2026-09-02T00:00:00Z"
curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/symbols/EURUSD"

EURUSD et XAUUSD ne sont que des exemples : mettez à leur place le ticker voulu, écrit exactement comme dans la liste des prix (groupée par marché : forex, métaux, indices, actions, énergies, crypto, avec une recherche) ou dans la liste des tickers (CSV). Plusieurs tickers se séparent par des virgules.

Deux produits, une seule clé API. L’API de prix de marché ci-dessous fournit les prix aux applications, robots et tableaux de bord. L’oracle de prix on-chain fournit les mêmes prix sous forme de rapports signés que les smart contracts vérifient on-chain.

Endpoints

Jusqu’où remontent les bougies : M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years (aussi loin que remonte l’historique propre du marché).

Oracle de prix on-chain (pour smart contracts)

Utilisez les mêmes prix du forex, de l’or, des indices et des actions dans des smart contracts, pour le prêt DeFi, les actifs tokenisés (RWA), le change on-chain, les paiements en stablecoins et les actifs synthétiques. Votre application récupère un rapport de prix signé ; votre contrat le transmet à notre contrat vérificateur, qui contrôle la signature on-chain. Le prix ne peut pas être falsifié en transit, et personne n’a à faire confiance au messager.

1. Récupérez un rapport avec votre clé API :

   curl -H "Authorization: Bearer $KEY" "https://api.marketapi.app/v1/oracle/report?symbols=XAUUSD&chain_id=10"

2. Soumettez son report et sa signature à la fonction submit() du vérificateur dans votre transaction.
3. Lisez le prix vérifié avec getPriceNoOlderThan(feedId, maxAge). Il ne renvoie qu’un prix en direct (marché OPEN) plus récent que maxAge.

Chaque rapport indique le statut du marché (OPEN, CLOSED, HALTED) et l’écart bid-ask, et expire environ une minute après la signature. Les flux ont des identifiants fixes (keccak256("XAUUSD")), des coupe-circuits bloquent les sauts anormaux, et un adaptateur compatible Chainlink (latestRoundData) est disponible. Les prix déjà stockés on-chain par notre relayeur peuvent être lus gratuitement.

Documentation de l’oracle Flux, réseaux et contrats

Offre gratuite (sans clé)

Essayez l’API sans compte : 10 requêtes par minute et 1000 par jour et par adresse IP, jusqu’à 5 symboles par requête.

curl "https://api.marketapi.app/v1/free/prices/latest?symbols=EURUSD"
curl "https://api.marketapi.app/v1/free/symbols"
curl "https://api.marketapi.app/v1/free/market-status?symbols=EURUSD"

Besoin de plus ? Créez un compte pour un accès complet avec votre propre clé API.

Statut du prix

Chaque prix porte un status qui ne dit qu’une chose : à quel point le prix est récent.

Ajoutez require_live=true pour ne recevoir que des prix LIVE ; les symboles exclus ne sont pas facturés. Chaque symbole demandé apparaît dans exactement une liste : data (a un prix), no_data (symbole connu, pas encore de prix) ou unknown (non proposé).

Horaires de négociation. Le forex, les métaux et la plupart des indices se négocient du dimanche soir au vendredi soir (UTC). Les CFD sur actions et ETF suivent la séance régulière de leur bourse en heure locale, avec l’heure d’été : New York 09:30–16:00, Londres 08:00–16:30, Francfort et Paris 09:00–17:30. Les jours fériés boursiers (NYSE, LSE, Xetra, Euronext) comptent comme fermés. En dehors de ces horaires, un prix est MARKET_CLOSED, pas STALE ; si la source cote quand même (par exemple avant l’ouverture), le prix est LIVE.

Spécifications des instruments

GET /v1/symbols/{symbol} renvoie la spécification complète de l’instrument telle que fournie par la source, y compris devises, taille de contrat, taille de tick et limites de volume, avec ses séances de négociation. GET /v1/symbols/{symbol}/properties/history liste chacune de ses modifications. La liste des symboles (CSV) inclut les principaux champs de spécification.

Nouvelles tentatives sûres

Envoyez un en-tête Idempotency-Key pour sécuriser les nouvelles tentatives : répéter une requête avec la même clé dans les 24 heures renvoie exactement la première réponse, sans facturation (réponses jusqu’à 2 Mo). Pour des données à jour, envoyez une nouvelle clé ; une clé dont la réponse n’est plus conservée reçoit 409 idempotency_key_used.

Prix en temps réel (robots de trading, tableaux de bord)

Deux façons d’obtenir le prix le plus frais. Les deux fournissent les mêmes cotations ; choisissez selon le fonctionnement de votre programme.

Quelle est la fraîcheur d’un prix ?

Les symboles que vous streamez, ou que vous avez demandés via /prices/latest au cours des 5 dernières minutes, sont rafraîchis depuis la source environ chaque seconde (jusqu’à symboles de ce type pour l’ensemble des clients à la fois). Tous les autres symboles sont rafraîchis en continu en arrière-plan, moins souvent. Donc : demandez ou abonnez-vous aux symboles que vous tradez, et ils deviennent rapides.

Chaque cotation porte time, le moment où la source l’a produite (UTC), et un status. Un programme de trading devrait toujours vérifier les deux :

• Utilisez require_live=true sur les appels REST : seuls les prix LIVE sont renvoyés (les autres sont listés à part et non facturés).
• Comparez time avec votre horloge et ignorez les cotations plus anciennes que ce que votre stratégie tolère. Les marchés peuvent être calmes : un prix peut légitimement ne pas changer pendant un moment.

Exemple REST

curl -H "Authorization: Bearer $API_KEY" \
  "https://api.marketapi.app/v1/prices/latest?symbols=EURUSD,XAUUSD&require_live=true"

{"data": [{"symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
           "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}],
 "not_live": [], "unknown": [], "no_data": []}

Interroger plus d’une fois par seconde n’apporte rien : c’est la fréquence de lecture de la source pour les symboles actifs.

Protocole WebSocket

Connectez-vous à /stream avec l’en-tête Authorization: Bearer <your key> (portée read:latest). Envoyez ensuite des messages JSON :

> {"action": "subscribe",   "symbols": ["EURUSD", "XAUUSD"]}
< {"type": "subscribed", "symbols": ["EURUSD", "XAUUSD"], "rejected": []}
< {"type": "quote", "symbol": "EURUSD", "bid": "1.12946", "ask": "1.12967", "last": null,
   "time": "2026-10-02T09:15:42.381Z", "status": "LIVE"}
> {"action": "unsubscribe", "symbols": ["XAUUSD"]}
< {"type": "error", "code": "...", "detail": "..."}

Limites : jusqu’à 50 symboles par connexion. Codes de fermeture : 4401 clé invalide, 4402 solde épuisé (rechargez puis reconnectez-vous), 4429 trop de connexions ouvertes. Le serveur envoie des pings toutes les 20 secondes ; la plupart des bibliothèques WebSocket y répondent automatiquement.

Exemple Python (pip install "websockets>=14")

import asyncio, json, os, websockets

async def main():
    url = "/stream"
    headers = {"Authorization": "Bearer " + os.environ["API_KEY"]}
    while True:                                   # reconnect with backoff
        try:
            async with websockets.connect(url, additional_headers=headers) as ws:
                await ws.send(json.dumps({"action": "subscribe", "symbols": ["EURUSD"]}))
                async for raw in ws:
                    msg = json.loads(raw)
                    if msg["type"] == "quote" and msg["status"] == "LIVE":
                        print(msg["symbol"], msg["bid"], msg["ask"], msg["time"])
        except websockets.ConnectionClosed as e:
            if e.code in (4401, 4402):            # wrong key / no balance: retrying will not help
                raise
        await asyncio.sleep(5)

asyncio.run(main())

Exemple Node.js (npm install ws)

const WebSocket = require("ws");
const ws = new WebSocket("/stream", { headers: { Authorization: "Bearer " + process.env.API_KEY } });
ws.on("open", () => ws.send(JSON.stringify({ action: "subscribe", symbols: ["EURUSD"] })));
ws.on("message", (raw) => {
  const m = JSON.parse(raw);
  if (m.type === "quote" && m.status === "LIVE") console.log(m.symbol, m.bid, m.ask, m.time);
});
ws.on("close", (code) => console.log("closed", code));   // reconnect after a few seconds unless 4401/4402

Gardez votre clé API sur votre serveur ou dans votre robot. Ne la mettez jamais dans des pages web ou des applications que d’autres peuvent ouvrir : quiconque possède la clé peut dépenser votre solde.

Bon à savoir

• Les prix sont les bid et ask propres de la source ; price_basis dans /symbols indique à partir de quel prix les barres sont construites. Ce sont des données de marché indicatives, pas un lieu d’exécution : vos ordres sont exécutés aux prix de votre propre courtier.
• Les heures sont toujours en UTC. Les décimaux sont des chaînes avec la précision propre de l’instrument, donc aucun arrondi n’est perdu.
• Pour l’historique (barres et ticks), voir les endpoints ci-dessus ; temps réel et historique partagent les mêmes symboles et clés.

Graphiques, indicateurs, outils de dessin et alertes de prix (site web)

Chaque symbole a un graphique interactif gratuit sur /price/<ticker>, par exemple /price/EURUSD. Ce sont des fonctions du site : elles ne consomment aucun crédit API, et un compte n’est nécessaire que pour enregistrer des analyses et créer des alertes.

Débutant avec les graphiques ? Apprenez chaque indicateur et outil de dessin en mots simples : l’idée, la formule, l’utilisation et un exemple.

Listes de suivi, comparaison, multi-graphique et screener (site web)

Idées de trading, profils et abonnements (site web)

Application mobile (iPhone et Android)

Connectez-vous avec votre compte pour retrouver vos listes de suivi avec prix en direct, le graphique complet (chaque indicateur, outil de dessin et l’assistant de figures, avec vos analyses enregistrées), les alertes de prix en notifications sur le téléphone (cochez push sur une alerte ; activez les notifications sous Compte dans l’application) et les idées de la communauté. La connexion à deux facteurs fonctionne comme sur le site. Chaque téléphone sur lequel vous vous connectez est listé sous Compte, où vous pouvez le déconnecter ; un nouveau mot de passe déconnecte tous les téléphones. Offres et recharges se gèrent sur ce site. Vous pouvez supprimer votre compte dans l’application ou ici sous Compte.

Inviter des amis (parrainage)

Sous Tableau de bord → Inviter des amis, vous trouvez votre lien personnel (/r/your-code ; ajoutez ?next=/premium ou n’importe quelle page de ce site pour y envoyer les gens). Toute personne qui l’ouvre et crée un compte dans les 30 jours vous est rattachée. Pendant 12 mois après son inscription, chaque recharge qu’elle paie (crypto sur les principaux réseaux ou carte, au moins 5 $) vous rapporte 20 %. Le cashback attend 14 jours en cas de remboursement, puis il est ajouté à votre solde : utilisez-le pour des crédits API, des offres ou Chart Premium. Vous pouvez aussi vous le faire verser (stablecoins ou PayPal) à partir de 50 $, confirmé par e-mail et vérifié par notre équipe. S’inviter soi-même ou inviter un second compte à soi ne compte pas, et il existe une limite mensuelle par parrain.

Programme partenaire (courtiers et formateurs)

Les entreprises offrent Chart Premium à leurs clients : postulez sous Tableau de bord → Partenaire ; une fois validé, vous recevez un identifiant partenaire et 5 places d’essai gratuites (14 jours de Pro chacune). Les places s’achètent par lots (10, 50, 250) à -30 %, pour Pro ou Pro+ et pour 1, 3, 6 ou 12 mois chacune, depuis votre solde. Chaque place devient un code d’activation à usage unique, créé sur la page partenaire ou via l’API partenaire, avec si vous le voulez votre propre référence client (conservée masquée). Les codes inutilisés peuvent être annulés et rendent leur place. Les clients saisissent le code sur la page Premium.

Assistant de figures (site web)

✦ Assistant sur le graphique analyse les bougies de l’unité de temps affichée et liste ce qu’il trouve, avec les règles validées par chaque résultat, un trade suggéré et des dessins que vous pouvez afficher sur le graphique ou garder comme les vôtres. C’est une analyse automatique des prix passés, pas un conseil en investissement. Comment lire un résultat, son historique, les intervalles de confiance et la significativité : le guide de l’assistant de figures.

Chart Premium (site web)

Les graphiques sont gratuits. Chart Premium ajoute davantage d’outils lourds pour 1, 3, 6 ou 12 mois, payés depuis le même solde prépayé que l’API (les périodes longues coûtent moins cher par mois).

Testeur de stratégie (site web)

Stratégie sur le graphique teste une stratégie de trading sur les bougies passées de l’unité de temps affichée et montre chaque trade sur le graphique, le profit, le drawdown, le taux de réussite et une courbe de capital comparée à l’achat-conservation. Choisissez une stratégie intégrée et modifiez ses paramètres, ou écrivez la vôtre en JavaScript. Connecté, vous pouvez tester sur jusqu’à 20,000 bougies et enregistrer jusqu’à 50 stratégies. Votre script s’exécute uniquement dans votre navigateur, dans un bac à sable qui ne peut atteindre ni internet, ni votre compte, ni ce site.

Le guide complet de la console de back-test explique chaque réglage et résultat, toute la référence du script (y compris les 71 indicateurs dans le code) et 11 exemples prêts à l’emploi.

const len = input("Average period", 50, { min: 2, max: 500 });
const avg = ta.sma(close, len);
plot(avg, "SMA " + len, "#2F80ED");

function onBar(i) {
  if (avg[i] == null) return;                       // still warming up
  if (position <= 0 && close[i] > avg[i]) long({ slPct: 2 });
  if (position >= 0 && close[i] < avg[i]) short({ slPct: 2 });
}

Partage d’analyses et clubs

Partagez une analyse avec un lien, ou travaillez ensemble dans un club : un espace de travail commun avec un chat et une étagère d’analyses graphiques.

Où vont les alertes : e-mail, Telegram, téléphone, navigateur et webhooks

# Python: check that a webhook really comes from us (Flask example)
import hashlib, hmac, time
from flask import Flask, request, abort
SECRET = b"your-webhook-secret"
app = Flask(__name__)

@app.post("/alerts")
def alerts():
    ts = request.headers.get("X-Alert-Timestamp", "")
    sig = request.headers.get("X-Alert-Signature", "").removeprefix("sha256=")
    good = hmac.new(SECRET, ts.encode() + b"." + request.get_data(), hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig, good) or abs(time.time() - int(ts or 0)) > 300:
        abort(401)
    alert = request.get_json()
    print(alert)            # your trading bot, Slack, a spreadsheet…
    return "ok"

Limites et erreurs (API de prix)

Votre compte : clés API, sécurité et équipes

Crédits, recharges et offres

Tâches

Les travaux lourds (analyses de figures, gros lots de codes, longs rapports) attendent dans une file équitable au lieu de ralentir le site. Tableau de bord → Tâches affiche chacun avec sa place dans la file et le délai prévu ; vous pouvez quitter la page, et vous êtes prévenu sur le tableau de bord (et par e-mail pour les longs) quand c’est terminé. Une tâche qui échoue est relancée automatiquement et ne disparaît jamais en silence.

Aide et assistance

• Tickets d’assistance : écrivez-nous depuis votre tableau de bord (avec captures d’écran) ; les réponses arrivent par e-mail et sur le ticket.
• Demander à l’IA (le bouton de chat en bas à droite) répond à tout moment aux questions sur la plateforme.
• Apprendre explique chaque indicateur et outil de dessin ; le blog propose des tutoriels ; le journal des modifications liste les nouveautés.
• Statut d’un prix : GET /v1/prices/latest indique LIVE, STALE ou MARKET_CLOSED pour chaque cotation (voir Statut du prix).

Indicateurs et dessins sont calculés dans votre navigateur. Graphiques, indicateurs et alertes sont des informations, pas des conseils en investissement.