Receh MarketsAPI Open Markets
Developer documentation

Receh Markets API

Free, read-only market data for aggregators such as CoinMarketCap and CoinGecko, and for developers building on Receh Markets. No API key, no sign-up. All data is read from the blockchain.

Aggregator endpointsQuick start
REST + JSONNo API keyRead-only

Overview

  • Base URL: https://cryptoreceh.com/markets/api/
  • Methods: GET and HEAD only. Any other method returns 405.
  • Format: JSON (application/json; charset=utf-8). Gzip and Brotli are supported.
  • Authentication: none. Rate limits apply per IP address (see below).
  • Endpoints: five stable endpoints under /api/cmc/* (see Aggregator endpoints). Only these are part of the public contract.
  • Networks: BNB Smart Chain (56) and Polygon (137). Pairs from all networks are served by the same API.
01

Quick start

Fetch every active pair with its price and 24h volume:

curl https://cryptoreceh.com/markets/api/cmc/summary

Fetch the order book of one pair (use an ID from the summary):

curl https://cryptoreceh.com/markets/api/cmc/orderbook/TOKEN_USDT

JavaScript (Node.js 18+ or any server-side runtime):

const res = await fetch("https://cryptoreceh.com/markets/api/cmc/ticker");
if (!res.ok) throw new Error("HTTP " + res.status);
const ticker = await res.json();
for (const [id, t] of Object.entries(ticker)) console.log(id, t.last_price, t.quote_volume);

Python:

import requests
r = requests.get("https://cryptoreceh.com/markets/api/cmc/summary", timeout=15)
r.raise_for_status()
for p in r.json():
    print(p["trading_pairs"], p["last_price"], p["quote_volume"])
Call it from a server, not from a browser page.

The API does not send CORS headers, so a web page on another domain cannot read it directly with fetch. Server-to-server requests (what aggregators and bots do) work normally.

02

Conventions & limits

Topic Behavior
Numbers In the aggregator endpoints, prices, volumes, and amounts are decimal strings without grouping or exponent notation (for example "0.00001234"). Parse them with a decimal type where precision matters. "0" means no value or no activity.
Price direction Always the price of 1 base token in quote token. For TOKEN_USDT a price of 0.5 means 1 TOKEN = 0.5 USDT.
24h window A rolling window of the last 24 hours (86,400 seconds) ending now, not a calendar day.
Timestamps All timestamps are milliseconds since the Unix epoch (UTC).
Caching /api/cmc/* responses carry Cache-Control: public, max-age=15. Polling more often than every 15 seconds returns the same data.
Rate limit A token bucket per IP address (IPv6 is grouped by /64): bursts up to 60 requests, refilling at about 15 requests per second. Beyond that you get 429 with a short JSON error message.
Fair use Do not hammer the service. See section 10 of the Terms of Use. Excessive requests are rate limited automatically.
Compression Send Accept-Encoding: br, gzip to reduce transfer size.
03

Aggregator endpoints

Five read-only endpoints in the layout used by CoinMarketCap exchange integrations: summary, ticker, assets, order book, and trades. They list only pairs that currently accept new orders. Paused, cancel-only, and hidden pairs are not included.

Endpoint Returns
GET /api/cmc/summary Array of all active pairs with last price, best bid/ask, 24h volume, change, high, and low.
GET /api/cmc/ticker Object keyed by pair ID with last price and 24h volumes.
GET /api/cmc/assets Object keyed by asset symbol with fees and contract addresses.
GET /api/cmc/orderbook/{pair_id} Full aggregated order book of one pair.
GET /api/cmc/trades/{pair_id} Trades of the last 24 hours for one pair, newest first.
04

Pair IDs

A pair ID is BASE_QUOTE built from the token symbols, for example TOKEN_USDT. Characters other than letters, digits, dots, and hyphens are removed from each symbol.

  • Normal caseSymbols only: TOKEN_USDT.
  • Same symbols on several networksIf an ID is already taken, or is shorter than 3 characters, the chain ID is appended: TOKEN_USDT_56.
  • Still ambiguousIf it is still taken, the first 6 hex characters of the pair contract address are appended as well.
Always read IDs from the API.

IDs are generated from the current list of pairs. If another pair with the same symbols is added later, a suffix may be appended to a newer pair's ID. Use /api/cmc/summary or /api/cmc/ticker as the source of IDs, and use the contract addresses from /api/cmc/assets to identify tokens reliably.

An unknown ID returns 404 with {"error":"not found"}. Pair IDs in the URL accept letters, digits, dots, underscores, and hyphens (up to 64 characters).

05

GET /api/cmc/summary

An overview of every active pair.

GET https://cryptoreceh.com/markets/api/cmc/summary
[
  {
    "trading_pairs": "TOKEN_USDT",
    "last_price": "0.5",
    "lowest_ask": "0.52",
    "highest_bid": "0.48",
    "base_volume": "120000",
    "quote_volume": "58000.25",
    "price_change_percent_24h": "2.5",
    "highest_price_24h": "0.55",
    "lowest_price_24h": "0.46"
  }
]
Field Description
trading_pairs Pair ID (see Pair IDs).
last_price Price of the last filled trade, in quote per 1 base. "0" if the pair has never traded.
lowest_ask Lowest sell order price in the last loaded order book. "0" if there is none or the book has not been loaded yet.
highest_bid Highest buy order price in the last loaded order book. "0" if there is none or the book has not been loaded yet.
base_volume 24h traded volume in base token.
quote_volume 24h traded volume in quote token.
price_change_percent_24h Percent change between the price 24 hours ago and the last price ("2.5" means +2.5%).
highest_price_24h / lowest_price_24h Highest and lowest trade price in the last 24 hours. "0" if there were no trades.
Best bid and ask are from a cache.

This endpoint does not query the blockchain. lowest_ask and highest_bid come from the most recent order book the server has loaded for that pair. For a live book, use the orderbook endpoint.

06

GET /api/cmc/ticker

Last price and volume for each pair, keyed by pair ID.

GET https://cryptoreceh.com/markets/api/cmc/ticker
{
  "TOKEN_USDT": {
    "base_id": "0x1111111111111111111111111111111111111111",
    "quote_id": "0x55d398326f99059fF775485246999027B3197955",
    "last_price": "0.5",
    "quote_volume": "58000.25",
    "base_volume": "120000",
    "isFrozen": "0"
  }
}
Field Description
base_id / quote_id The token contract address. For a network's native coin (for example BNB) it is the coin symbol instead, since a native coin has no contract.
last_price Last trade price in quote per 1 base.
base_volume / quote_volume 24h volume in base and quote token.
isFrozen Always "0". Only pairs that accept new orders are listed.
07

GET /api/cmc/assets

Every token that appears in an active pair, with fees and contract address.

GET https://cryptoreceh.com/markets/api/cmc/assets
{
  "TOKEN": {
    "name": "TOKEN",
    "can_withdraw": "false",
    "can_deposit": "false",
    "min_withdraw": "0",
    "max_withdraw": "0",
    "maker_fee": "0.001",
    "taker_fee": "0.001",
    "contract_address": "0x1111111111111111111111111111111111111111"
  }
}
Field Description
key The token symbol. If two tokens share a symbol, the chain ID is appended to the later one (for example TOKEN_137).
can_deposit / can_withdraw Always "false". Receh Markets is non-custodial: there are no deposits or withdrawals. Funds stay in the user's wallet, or in the pair contract only while an order is open.
min_withdraw / max_withdraw Always "0" for the same reason.
maker_fee / taker_fee The trading fee as a decimal fraction: "0.001" is 0.1%. Maker and taker pay the same fee, which is set per pair and can change within the contract's maximum of 1%. The value shown is taken from the first active pair that uses this token.
contract_address Token contract address. Not present for native coins.
08

GET /api/cmc/orderbook/{pair_id}

The live order book of one pair. Orders at the same price are merged into one level.

GET https://cryptoreceh.com/markets/api/cmc/orderbook/TOKEN_USDT
{
  "timestamp": 1760000000000,
  "bids": [["0.48", "1500"], ["0.47", "900"]],
  "asks": [["0.52", "800"], ["0.55", "2000"]]
}
Field Description
timestamp When the book was read, in milliseconds.
bids Buy levels as [price, base_amount], highest price first.
asks Sell levels as [price, base_amount], lowest price first.

Amounts are always in base token. The whole book is returned (there is no depth parameter). The data is read from the contract through a cached snapshot, so it can lag the chain by a few seconds.

09

GET /api/cmc/trades/{pair_id}

Filled trades of the last 24 hours, newest first, up to 1,000 trades.

GET https://cryptoreceh.com/markets/api/cmc/trades/TOKEN_USDT
[
  {
    "trade_id": 4821350000012,
    "price": "0.5",
    "base_volume": "1000",
    "quote_volume": "500",
    "timestamp": 1760000000000,
    "type": "buy"
  }
]
Field Description
trade_id A unique numeric ID: block_number × 1,000,000 + log_index. It is stable and unique within a network. Use it to de-duplicate.
price Execution price in quote per 1 base.
base_volume / quote_volume Trade size in base and quote token. quote_volume is the amount in quote token.
timestamp Block time in milliseconds.
type "buy" if the taker bought (the buyer took a resting sell order), "sell" if the taker sold.

An empty array [] means the pair had no trades in the last 24 hours. Each trade corresponds to an on-chain transaction that can be verified on the network's block explorer.

10

Errors

Errors are JSON of the form {"error": "message"} with an HTTP status code. Rely on the status code, not the message text.

Status Meaning
404 Unknown pair ID or unknown endpoint.
405 A method other than GET or HEAD was used.
429 too many requests. Wait a few seconds and retry with backoff.
5xx Server problem. Retry later.
11

Data notes

  • On-chain sourceTrades, prices, and order books are read from the smart contracts of each pair. Every trade can be checked on the network's block explorer.
  • Slight delayData can lag the chain by a few seconds and is only final after several block confirmations. A very recent trade can disappear in the rare event of a chain reorganization.
  • Last price on thin marketsThe last price is the last filled trade. On a quiet market it can differ from the best bid and ask. Use lowest_ask and highest_bid (or the order book) for executable prices.
  • VolumeVolume counts filled trades only, not open orders. Every trade is on-chain and can be verified on the network's block explorer.
  • FeesThe trading fee is deducted from what the receiver gets, is set per pair, and is capped at 1% in the contract.
  • Rupiah valuesAny Rupiah figure on the website is only an estimate. The API returns prices in the pair's quote token.
12

For exchange listings

If you are applying to list Receh Markets on a data aggregator, you can submit this page and the endpoints below:

Item Value
Documentation https://cryptoreceh.com/markets/api-docs/
Summary https://cryptoreceh.com/markets/api/cmc/summary
Ticker https://cryptoreceh.com/markets/api/cmc/ticker
Assets https://cryptoreceh.com/markets/api/cmc/assets
Order book https://cryptoreceh.com/markets/api/cmc/orderbook/{pair_id}
Trades https://cryptoreceh.com/markets/api/cmc/trades/{pair_id}
Type of exchange Decentralized, non-custodial, on-chain limit order book. No deposits or withdrawals.
Networks BNB Smart Chain (56), Polygon (137)
Pair pages https://cryptoreceh.com/markets/{slug}/, listed in sitemap.xml

Questions or integration requests?

Use the contact links in the site footer or the contact form at cryptoreceh.com/contact.

Open Receh Markets