Overview
- Base URL:
https://receh.web.id/api/ - Methods:
GETandHEADonly. Any other method returns405. - Format: JSON (
application/json; charset=utf-8), except the event stream. Gzip and Brotli are supported. - Authentication: none. Rate limits apply per IP address (see below).
- Scope: only the five aggregator endpoints (
/api/cmc/*) are public and supported. Other paths under/api/belong to the web app, are not documented, and may change or be blocked without notice. - Networks: BNB Smart Chain (56), Polygon (137), Core Chain (1116), and Riche Chain (132026). Pairs from all networks are served by the same API.
Quick start
Fetch every active pair with its price and 24h volume:
curl https://receh.web.id/api/cmc/summary
Fetch the order book of one pair (use an ID from the summary):
curl https://receh.web.id/api/cmc/orderbook/TOKEN_USDT
JavaScript (Node.js 18+ or any server-side runtime):
const res = await fetch("https://receh.web.id/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://receh.web.id/api/cmc/summary", timeout=15)
r.raise_for_status()
for p in r.json():
print(p["trading_pairs"], p["last_price"], p["quote_volume"])
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.
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 | Aggregator endpoints use milliseconds since the Unix epoch (UTC). Trade timestamps are in milliseconds too. |
| 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 {"error":"too many requests"}. |
| 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. |
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. |
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.
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).
GET /api/cmc/summary
An overview of every active pair.
GET https://receh.web.id/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. |
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.
GET /api/cmc/ticker
Last price and volume for each pair, keyed by pair ID.
GET https://receh.web.id/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. |
GET /api/cmc/assets
Every token that appears in an active pair, with fees and contract address.
GET https://receh.web.id/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 Exchange 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. |
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://receh.web.id/api/cmc/orderbook/TOKEN_USDT?depth=20&level=2
{
"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. Optional query parameters: depth (0 = full book, default; otherwise the total number of levels, split evenly between bids and asks, e.g. depth=100 returns up to 50 bids and 50 asks) and level (1 = best bid and best ask only; 2 or omitted = aggregated by price). Level 3 (non-aggregated) is not offered; it is served as level 2. The data is read from the contract through a cached snapshot, so it can lag the chain by
a few seconds.
GET /api/cmc/trades/{pair_id}
Filled trades of the last 24 hours, newest first, up to 1,000 trades.
GET https://receh.web.id/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.
Errors
Errors are JSON of the form {"error": "message"} with an HTTP status code.
| Status | Meaning |
|---|---|
404 |
not found (unknown aggregator pair ID) or an 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. |
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_askandhighest_bid(or the order book) for executable prices. -
VolumeVolume counts filled trades only, not open orders. One wallet can trade with itself. Each trade can be verified on the 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.
For exchange listings
If you are applying to list Receh Exchange on a data aggregator, you can submit this page and the endpoints below:
| Item | Value |
|---|---|
| Documentation | https://receh.web.id/api-docs/ |
| Summary | https://receh.web.id/api/cmc/summary |
| Ticker | https://receh.web.id/api/cmc/ticker |
| Assets | https://receh.web.id/api/cmc/assets |
| Order book | https://receh.web.id/api/cmc/orderbook/{pair_id} |
| Trades | https://receh.web.id/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), Core Chain (1116), Riche Chain (132026) |
Questions or integration requests?
Use the contact links in the site footer or the contact form at cryptoreceh.com/contact.
Open Receh Exchange