Candle Data API

Licensed 1-minute market candles and live prices. Base URL: https://quotexapi.bangladeshitrader.com/v1

বাংলায় দ্রুত শুরু
  1. আপনার API Key (যেমন CNDL-XXXX-XXXX-XXXX-XXXX) প্রতিটি রিকোয়েস্টের হেডারে দিন: X-API-Key: আপনার-কী
  2. ক্যান্ডেল দেখতে: https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=100
  3. পেয়ারের তালিকা: https://quotexapi.bangladeshitrader.com/v1/pairs — লাইভ দাম: https://quotexapi.bangladeshitrader.com/v1/tick?pair=EURUSD_otc
  4. Excel / Google Sheets-এ নিতে লিংকের শেষে &format=csv&apikey=আপনার-কী যোগ করুন।
  5. পুরো এক মাসের M1 ক্যান্ডেল (প্রায় ৪৩,২০০টি): https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=50000&compact=1 — compact=1 দিলে ডাটা ছোট হয়, চার্টের জন্য ভালো। বিস্তারিত নিচে "Getting a full month" অংশে।
  6. সময় সবসময় UTC (বাংলাদেশ সময় = UTC + ৬ ঘণ্টা)। মেয়াদ বা সীমা দেখতে: https://quotexapi.bangladeshitrader.com/v1/account

Quick start

curl -H "X-API-Key: YOUR_KEY" \
  "https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=5"

Authentication

Send your license key with every request, in one of these ways:

Keep your key private. If you think it leaked, ask the provider to reissue it — the old key stops working immediately. Your license has an expiry date, a request limit per minute and a limit on how many different IP addresses may use it; see /v1/account.

Endpoints

All times are UTC. time is the candle's open time in Unix seconds, utc is the same as text.

GET /v1/candles

ParameterDescription
pair *e.g. EURUSD_otc, EURUSD, XAUUSD (see /v1/pairs)
tfM1 (default), M5, M15, M30, H1, H4. Larger timeframes are built from the 1-minute candles; only closed candles are returned.
limitNumber of candles (default 500). The maximum depends on your license, up to 50,000 per request. A full month of M1 is about 43,200 candles — see Getting a full month.
toLatest candle to include: Unix seconds or YYYY-MM-DD HH:MM (UTC). Default: now.
fromIf given, returns the first limit candles starting at this time (use it to page forward through history). Without it you get the latest limit candles.
formatjson (default) or csv
compact1 for a much smaller JSON: data becomes arrays [time, open, high, low, close] (plus n for tf above M1) in the order given by columns. Recommended for big requests and charts.
include_filler1 to also return flat "market closed" candles (see Data notes). Default 0.
{
  "success": true, "pair": "EURUSD_otc", "tf": "M1", "period": 60, "tz": "UTC",
  "count": 2, "limit": 2, "newest_candle_utc": "2026-10-25 15:35:00",
  "gaps": [],
  "data": [
    {"time":1792942440,"utc":"2026-10-25 15:34:00","open":1.11839,"high":1.11872,"low":1.11837,"close":1.11865,"colour":"green"},
    {"time":1792942500,"utc":"2026-10-25 15:35:00","open":1.11865,"high":1.11865,"low":1.1182,"close":1.11852,"colour":"red"}
  ]
}

For tf other than M1 each candle also has n — how many 1-minute candles were combined (normally equal to the timeframe's minutes).

GET /v1/pairs

All pairs of your license with the latest price, payout %, category, otc flag, time of the last candle and market_open. Optional filters: category=currency|crypto|commodity|index, otc=1|0.

GET /v1/tick?pair=EURUSD_otc

Latest live price: price, timestamp, age_s (seconds since that price) and stale (true if older than 15 s). GET /v1/ticks returns all pairs at once. Only a price is provided (no bid/ask).

GET /v1/account

Your license: status, expiry, days left, allowed pairs/timeframes, limits and today's usage.

GET /health

No key needed. collector is ok, degraded or down — whether fresh data is currently arriving.

Examples

Python

import requests

BASE = "https://quotexapi.bangladeshitrader.com/v1"
HEADERS = {"X-API-Key": "YOUR_KEY"}

r = requests.get(f"{BASE}/candles", headers=HEADERS,
                 params={"pair": "EURUSD_otc", "tf": "M5", "limit": 200}, timeout=15)
r.raise_for_status()
for c in r.json()["data"]:
    print(c["utc"], c["open"], c["high"], c["low"], c["close"])

JavaScript

const res = await fetch("https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=100",
                        { headers: { "X-API-Key": "YOUR_KEY" } });
const { data } = await res.json();
console.log(data[data.length - 1]);

Excel / Google Sheets

Google Sheets: =IMPORTDATA("https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=200&format=csv&apikey=YOUR_KEY")
Excel: Data → From Web and paste the same URL.

Paging through history

t = 1790000000            # start (Unix seconds)
while True:
    d = requests.get(f"{BASE}/candles", headers=HEADERS,
                     params={"pair": "EURUSD_otc", "from": t, "limit": 1000}).json()["data"]
    if not d: break
    handle(d)
    t = d[-1]["time"] + 60

Getting a full month

One request can return up to 50,000 candles (if your license allows it). Sizes for 30 days of one pair:

TimeframeCandlesTypical size
M1about 43,200about 6 MB as JSON, 2 MB with compact=1 (gzip makes it several times smaller on the wire)
M5about 8,640about 1 MB
M15 / H12,880 / 720under 0.5 MB
import requests

r = requests.get("https://quotexapi.bangladeshitrader.com/v1/candles", headers={"X-API-Key": "YOUR_KEY"},
                 params={"pair": "EURUSD_otc", "tf": "M1", "limit": 50000, "compact": 1}, timeout=60)
d = r.json()
print(d["count"], d["columns"])
for t, o, h, l, c in d["data"]:          # time (Unix seconds), open, high, low, close
    pass

Errors

Errors are JSON: {"success": false, "error": "code", "message": "..."}. Respect the Retry-After header on 429. Every response carries X-RateLimit-Limit and X-RateLimit-Remaining (requests per minute).

HTTPerrorMeaning
400missing_parameter, invalid_timeframe, invalid_limit, invalid_time, invalid_formatCheck the request parameters.
401invalid_api_keyKey missing or wrong.
403license_expired, license_revoked, license_suspendedContact the provider.
403pair_not_allowed, timeframe_not_allowed, ticks_not_allowedNot included in your license.
403ip_limit_reached, ip_not_allowedThe key was used from too many IP addresses (last 24 h) or from a non-approved address.
404pair_not_found, no_dataUnknown pair or no data yet.
429rate_limited, daily_quota_exceeded, too_many_failuresSlow down; wait Retry-After seconds. Repeated invalid keys block an address for 15 minutes.
503server_busySeveral large requests are running; retry after Retry-After seconds.

Data notes