Developer API · v1

API documentation

Closed one-minute candles, open/closed charts, and the live forming bar for Binomo. Same JSON your bot or chart can poll. No API key.

Base URLthis host

AuthenticationNone. GET only.

Candle sizeM1, up to 8 days

Default timezoneUTC+6

Candles stored 17,020 Charts open ··· Feed ···

/health /api/v1/markets /api/v1/candles /api/v1/tick

Quick start

Pick a pair symbol such as EURUSD or EURUSD_otc.
Read closed candles with count. Newest candle is first.
Read /api/v1/tick for the price that is still forming this minute.

curl

curl "__ORIGIN__/api/v1/candles?pair=EURUSD&count=5&timezone=UTC%2B6"

response

{
  "success": true,
  "pair": "EURUSD",
  "timeframe": "M1",
  "timezone": "UTC+6",
  "open": true,
  "payout": 0,
  "count": 5,
  "data": [
    {
      "pair": "EURUSD",
      "time": "2026-11-02 12:01:00",
      "epoch": 1790000000,
      "open": 1.11558,
      "high": 1.11570,
      "low": 1.11540,
      "close": 1.11562,
      "colour": "green",
      "payout": 0
    }
  ]
}

Response shape

Every candle is one closed minute. colour is green when close is greater than or equal to open, otherwise red. time is the candle open, shifted into the timezone you asked for. epoch stays UTC.

Pair names drop the slash. EUR/USD is EURUSD. An OTC name ending in (OTC) becomes EURUSD_otc.

The current minute is never inside /candles. It is the forming object on /tick. History older than 8 days is deleted.

Endpoint reference

GET/health

Process liveness. Always HTTP 200 while this service can answer, including while the broker feed is reconnecting.

Field	Meaning
`binomo`	`true` when the worker is connected
`worker`	`CONNECTED`, `CONNECTING`, `CONN_FAILED`, or `ERROR`
`tick_silence_s`	Seconds since the last price. `-1` means no tick yet
`mongo`	Database ping

example

curl "__ORIGIN__/health"

GET/api/v1/markets

Every pair the worker knows, with payout and whether the broker chart is open right now.

Field	Meaning
`data[].symbol`	API pair name
`data[].open`	Chart is in session
`data[].payout_percent`	Last known payout
`open_pairs`	Symbols currently open

example

curl "__ORIGIN__/api/v1/markets"

GET/api/v1/status

Open flag, payout, and the time of the newest stored candle for one pair.

Query		Notes
`pair`	required	Also accepts `symbol`. Example `EURUSD`

example

curl "__ORIGIN__/api/v1/status?pair=EURUSD"

GET/api/v1/candles

Latest closed M1 candles, newest first. Alias: /candles.

Query		Notes
`pair`	required	`EURUSD`, `EURUSD_otc`. Alias `symbol`
`count`	optional	Default 100. Max 11520. Alias `limit`
`timeframe`	optional	`M1`
`timezone`	optional	`UTC`, `UTC+6`, `UTC+5:30`, `PKT`. Default UTC+6

example

curl "__ORIGIN__/api/v1/candles?pair=EURUSD_otc&count=20&timezone=UTC%2B6"

GET/api/v1/tick

Latest price and the forming M1 candle. Alias: /tick. Without pair, returns one row per live pair.

Query		Notes
`pair`	optional	Omit it to list every live pair

example

curl "__ORIGIN__/api/v1/tick?pair=EURUSD"

GET/api/v1/ticks

Same as /api/v1/tick with no pair. Alias: /ticks.

example

curl "__ORIGIN__/api/v1/ticks"

Try a request

Runs against this server and prints the JSON below.

/api/v1/candles

Send a pair to see the live JSON.

Command	What it does
`/status`	Connection, balance, silence, candles stored
`/health`	Worker snapshot
`/pairs`	Open and closed charts
`/pair EURUSD`	One pair, payout, last candle
`/candles EURUSD 10`	Recent M1 rows
`/tick EURUSD`	Forming minute
`/reconnect`	Open the feed again
`/alerts on`	Push a message when the feed drops or returns

API documentation

Quick start

Response shape

Endpoint reference

Try a request

Telegram