API quick start

Credit price: $0.001 (1000 free credits on sign-up). Base URL https://api.marketapi.app/v1. Send your key in the Authorization header. Keys in URLs are rejected.

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 and XAUUSD are only examples: put the ticker you want in their place, written exactly as on the price list (grouped by market: forex, metals, indices, stocks, energies, crypto, with a search) or in the ticker list (CSV). Several tickers are separated by commas.

Two products, one API key. The market price API below serves prices to apps, bots and dashboards. The on-chain price oracle serves the same prices as signed reports that smart contracts verify on-chain.

Endpoints

How far back candles go: M1 7 days · M2–M6 30 days · M10–M30 3 months · H1 12 months · H2–H12 3 years · D1–MN1 5 years (as far as the market's own history reaches).

On-chain price oracle (for smart contracts)

Use the same forex, gold, index and stock prices inside smart contracts, for DeFi lending, tokenized assets (RWA), on-chain FX, stablecoin payments and synthetic assets. Your app fetches a signed price report; your contract passes it to our verifier contract, which checks the signature on-chain. The price cannot be forged in transit, and nobody has to trust the messenger.

1. Fetch a report with your API key:

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

2. Submit its report and signature to the verifier's submit() in your transaction.
3. Read the verified price with getPriceNoOlderThan(feedId, maxAge). It only returns a live price (market OPEN) younger than maxAge.

Every report states the market status (OPEN, CLOSED, HALTED) and the bid-ask spread, and expires about a minute after signing. Feeds have fixed IDs (keccak256("XAUUSD")), circuit breakers stop abnormal jumps, and a Chainlink-compatible adapter (latestRoundData) is available. Prices our relayer has already stored on-chain can be read for free.

Oracle documentation Feeds, networks and contracts

Free tier (no key)

Try the API without an account: 10 requests per minute and 1000 per day per IP address, up to 5 symbols per request.

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"

Need more? Create an account for full access with your own API key.

Price status

Every price carries a status that says only one thing: how current the price is.

Add require_live=true to receive only LIVE prices; excluded symbols are not billed. Every requested ticker appears in exactly one list: data (has a price), no_data (known ticker, no price yet) or unknown (not offered).

Trading hours. Forex, metals and most indices trade from Sunday evening to Friday evening (UTC). Share and ETF CFDs follow their exchange's regular session in local time, with daylight saving: New York 09:30–16:00, London 08:00–16:30, Frankfurt and Paris 09:00–17:30. Exchange holidays (NYSE, LSE, Xetra, Euronext) count as closed. Outside these hours a price is MARKET_CLOSED, not STALE; if the source quotes anyway (for example before the open), the price is LIVE.

Instrument specifications

GET /v1/symbols/{symbol} returns the instrument's complete specification as reported by the source, including currencies, contract size, tick size and volume limits, together with its trading sessions. GET /v1/symbols/{symbol}/properties/history lists every change to it. The ticker list (CSV) includes the main specification fields.

Safe retries

Send an Idempotency-Key header to make retries safe: repeating a request with the same key within 24 hours returns exactly the first answer again, without charging (answers up to 2 MB). For current data, send a new key; a key whose answer is no longer kept gets 409 idempotency_key_used.

Real-time prices (trading bots, dashboards)

Two ways to get the freshest price. Both deliver the same quotes; choose by how your program works.

How fresh is a price?

Symbols you are streaming, or have requested via /prices/latest in the last 5 minutes, are refreshed from the source about every second (up to such symbols across all customers at a time). All other symbols are refreshed continuously in the background, less often. So: request or subscribe to the symbols you trade, and they become fast.

Every quote carries time, the moment the source produced it (UTC), and a status. A trading program should always check both:

• Use require_live=true on REST calls: only LIVE prices are returned (others are listed separately and not billed).
• Compare time with your clock and ignore quotes older than your strategy tolerates. Markets can be quiet: a price may legitimately not change for a while.

REST example

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": []}

Polling faster than once per second gains nothing: that is how often the source is read for active symbols.

WebSocket protocol

Connect to /stream with the header Authorization: Bearer <your key> (scope read:latest). Then send JSON messages:

> {"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": "..."}

Limits: up to 50 symbols per connection. Close codes: 4401 invalid key, 4402 balance used up (top up, then reconnect), 4429 too many open connections. The server sends pings every 20 seconds; most WebSocket libraries answer them automatically.

Python example (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())

Node.js example (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

Keep your API key on your server or in your bot. Never put it in web pages or apps that other people can open: anyone who has the key can spend your balance.

Good to know

• Prices are the source's own bid and ask; price_basis in /symbols states which price the bars are built from. They are indicative market data, not an execution venue: your orders are filled at your own broker's prices.
• Times are always UTC. Decimals are strings with the instrument's own precision, so no rounding is lost.
• For history (bars and ticks) see the endpoints above; real-time and history share the same symbols and keys.

Charts, indicators, drawing tools and price alerts (website)

Every ticker has a free interactive chart at /price/<ticker>, for example /price/EURUSD. These are website features: they use no API credits, and you need an account only to save analyses and set alerts.

New to charts? Learn every indicator and drawing tool in plain words: the idea, the formula, how to use it and an example.

Watchlists, compare, multi-chart and the screener (website)

Trading ideas, profiles and following (website)

Mobile app (iPhone and Android)

Sign in with your account to get your watchlists with live prices, the full chart (every indicator, drawing tool and the pattern wizard, with your saved analyses), price alerts as phone notifications (tick push on an alert; switch notifications on under Account in the app) and the community's ideas. Two-factor sign-in works as on the website. Every phone you sign in on is listed under Account, where you can sign it out; a new password signs out every phone. Plans and top-ups are managed on this website. You can delete your account in the app or under Account here.

Invite friends (referrals)

Under Dashboard → Invite friends you find your personal link (/r/your-code; add ?next=/premium or any page of this site to send people there). Someone who opens it and creates an account within 30 days is linked to you. For 12 months after their sign-up, every top-up they pay (crypto on the main networks or card, at least $5) earns you 20%. Cashback waits 14 days in case of a refund, then it is added to your balance: spend it on API credits, plans or Chart Premium. You can also have it paid out (stablecoins or PayPal) from $50, confirmed by e-mail and checked by our team. Inviting yourself or a second account of your own does not count, and there is a monthly limit per inviter.

Partner programme (brokers and educators)

Businesses give their clients Chart Premium: apply under Dashboard → Partner; once approved you get a partner ID and 5 free trial seats (14 days of Pro each). Seats are bought in packs (10, 50, 250) at 30% off, for Pro or Pro+ and 1, 3, 6 or 12 months each, from your balance. Each seat becomes a one-time activation code, made on the partner page or through the partner API, optionally with your own client reference (kept masked). Unused codes can be cancelled and give their seat back. Clients enter the code on the Premium page.

Pattern wizard (website)

✦ Wizard on the chart scans the candles of the timeframe on screen and lists what it finds, with the rules each finding passed, a suggested trade and drawings you can show on the chart or keep as your own. It is automatic analysis of past prices, not investment advice. How to read a finding, its track record, confidence intervals and significance: the pattern wizard guide.

Chart Premium (website)

The charts are free. Chart Premium adds more of the heavy tools for 1, 3, 6 or 12 months, paid from the same prepaid balance as the API (longer periods cost less per month).

Strategy tester (website)

Strategy on the chart tests a trading strategy on past candles of the timeframe on screen and shows every trade on the chart, the profit, the drawdown, the win rate and an equity curve against buy and hold. Pick a built-in strategy and change its inputs, or write your own in JavaScript. Signed in, you can test on up to 20,000 candles and save up to 50 strategies. Your script runs only in your browser, in a sandbox that cannot reach the internet, your account or this site.

The complete backtest console guide explains every setting and result, the whole script reference (including all 71 indicators in code) and 11 ready-to-run examples.

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 });
}

Sharing analyses and clubs

Share one analysis with a link, or work together in a club: a shared work area with a chat and a shelf of chart analyses.

Where alerts go: e-mail, Telegram, phone, browser and 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"

Limits and errors (price API)

Your account: API keys, security and teams

Credits, top-ups and plans

Tasks

Heavy work (pattern scans, large batches of codes, long reports) waits in a fair queue instead of slowing the site. Dashboard → Tasks shows each one with its place in the queue and the expected time; you can leave the page, and you are told on the dashboard (and by e-mail for long ones) when it is done. A task that fails is retried automatically and never disappears silently.

Help and support

• Support tickets: write to us from your dashboard (with screenshots); answers arrive by e-mail and on the ticket.
• Ask AI (the chat button at the bottom right) answers questions about the platform at any time.
• Learn explains every indicator and drawing tool; the blog has tutorials; the changelog lists what is new.
• Status of a price: GET /v1/prices/latest says LIVE, STALE or MARKET_CLOSED for every quote (see Price status).

Indicators and drawings are calculated in your browser. Charts, indicators and alerts are information, not investment advice.