Candle Data API
Licensed 1-minute market candles and live prices. Base URL: https://quotexapi.bangladeshitrader.com/v1
- আপনার API Key (যেমন
CNDL-XXXX-XXXX-XXXX-XXXX) প্রতিটি রিকোয়েস্টের হেডারে দিন:X-API-Key: আপনার-কী - ক্যান্ডেল দেখতে:
https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=100 - পেয়ারের তালিকা:
https://quotexapi.bangladeshitrader.com/v1/pairs— লাইভ দাম:https://quotexapi.bangladeshitrader.com/v1/tick?pair=EURUSD_otc - Excel / Google Sheets-এ নিতে লিংকের শেষে
&format=csv&apikey=আপনার-কীযোগ করুন। - পুরো এক মাসের M1 ক্যান্ডেল (প্রায় ৪৩,২০০টি):
https://quotexapi.bangladeshitrader.com/v1/candles?pair=EURUSD_otc&tf=M1&limit=50000&compact=1—compact=1দিলে ডাটা ছোট হয়, চার্টের জন্য ভালো। বিস্তারিত নিচে "Getting a full month" অংশে। - সময় সবসময় 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:
- Header (recommended):
X-API-Key: YOUR_KEYorAuthorization: Bearer YOUR_KEY - Query string (for tools that cannot set headers, e.g. spreadsheets):
?apikey=YOUR_KEY. Keys in URLs can end up in browser history and logs, so prefer the header in programs.
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
| Parameter | Description |
|---|---|
pair * | e.g. EURUSD_otc, EURUSD, XAUUSD (see /v1/pairs) |
tf | M1 (default), M5, M15, M30, H1, H4. Larger timeframes are built from the 1-minute candles; only closed candles are returned. |
limit | Number 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. |
to | Latest candle to include: Unix seconds or YYYY-MM-DD HH:MM (UTC). Default: now. |
from | If 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. |
format | json (default) or csv |
compact | 1 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_filler | 1 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:
| Timeframe | Candles | Typical size |
|---|---|---|
M1 | about 43,200 | about 6 MB as JSON, 2 MB with compact=1 (gzip makes it several times smaller on the wire) |
M5 | about 8,640 | about 1 MB |
M15 / H1 | 2,880 / 720 | under 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
- Send
Accept-Encoding: gzip(browsers,requests,fetchandcurl --compresseddo this automatically). - Big requests count as several requests of your per-minute allowance (every 10,000 candles asked for adds one), and only a couple of big requests run at the same time. If the server is busy you get
503 server_busy: wait the number of seconds inRetry-Afterand try again. - For a chart you can also load the latest part first (for example
limit=2000) and fetch older candles later withto=, or use a larger timeframe for the long view. - The history starts when the provider began collecting and reaches back about 30 days;
counttells you how many candles you really received.
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).
| HTTP | error | Meaning |
|---|---|---|
| 400 | missing_parameter, invalid_timeframe, invalid_limit, invalid_time, invalid_format | Check the request parameters. |
| 401 | invalid_api_key | Key missing or wrong. |
| 403 | license_expired, license_revoked, license_suspended | Contact the provider. |
| 403 | pair_not_allowed, timeframe_not_allowed, ticks_not_allowed | Not included in your license. |
| 403 | ip_limit_reached, ip_not_allowed | The key was used from too many IP addresses (last 24 h) or from a non-approved address. |
| 404 | pair_not_found, no_data | Unknown pair or no data yet. |
| 429 | rate_limited, daily_quota_exceeded, too_many_failures | Slow down; wait Retry-After seconds. Repeated invalid keys block an address for 15 minutes. |
| 503 | server_busy | Several large requests are running; retry after Retry-After seconds. |
Data notes
- Source and delay. Candles are built from live prices and published about 3–5 seconds after each minute closes. The still-forming minute is not included; use
/v1/tickfor the current price. - OTC pairs (
_otc) are the broker's own continuous markets — they trade around the clock and are not the interbank market's prices. - Closed markets. When a real market is closed (weekends, holidays) its price does not move and the collector records identical flat candles. Runs of 10 or more such candles are treated as filler and left out by default (
include_filler=1returns them).market_openin/v1/pairstells you the current state. - Gaps. If the data feed was interrupted, some minutes are missing. M1 responses list them under
gapsso you can handle or ignore them. - History reaches back about 30 days (the newest ~50 hours plus a daily archive); older candles are not available. Collection started on 24 Oct 2026, so until a full month has accumulated you get everything collected so far.
- Data is provided for information only and is not trading advice. No profit is guaranteed, and availability is provided on a best-effort basis.