Exchange codes and Coinray symbols
Every market in Altrady is identified by a Coinray symbol: a short exchange code, then the quote currency, then the base currency, joined by underscores. BTC/USDT on Binance is BINA_USDT_BTC. You will meet this symbol in deep links, in the trade setup API, in webhook payloads, and in the app’s own address bar. This article lists the exchange codes and explains how to read and build a symbol correctly.
How a Coinray symbol is built
<EXCHANGE CODE>_<QUOTE>_<BASE>
| Part | Example | Meaning |
|---|---|---|
| Exchange code | BINA |
Which exchange, from the table below. |
| Quote | USDT |
The currency you pay with. |
| Base | BTC |
The asset you buy or sell. |
So BINA_USDT_BTC reads as “on Binance, priced in USDT, trading BTC”. A few more real examples:
| Market | Coinray symbol |
|---|---|
| BTC/USDT on Binance | BINA_USDT_BTC |
| ETH/BTC on Coinbase | GDAX_BTC_ETH |
| BTC/GBP on Coinbase | GDAX_GBP_BTC |
| BTC/USDC on Hyperliquid Futures | HYPERLIQUIDF_USDC_BTC |
| BTC/USD on Kraken Futures | KRKNF_USD_BTC |
| BTC/USDT perpetual on OKX Futures | OKEXF_USDT_BTC_SWAP |
Everything is uppercase, and the order is quote before base. That is the opposite of how a pair is usually written (BTC/USDT), which is the single most common mistake when composing a symbol by hand.
Some symbols have a fourth segment
Futures exchanges that list several contracts for the same pair add a contract segment after the base:
OKEXF_USDT_BTC_SWAP
OKEXF_USDC_BTC_UM-XPERP-310404
The fourth segment can contain dashes and digits. Never assume a symbol has exactly three parts. When you parse one, split on the first two underscores only: the exchange code is everything before the first underscore, the quote is between the first and second, and the rest is the base plus any contract segment.
Do not compose symbols, look them up
Coinray symbols are assigned by Altrady’s market data service, not by a formula you can apply yourself. Base and quote currencies are sometimes not what you expect: Binance Futures lists BIFU_U_BTC next to BIFU_USDT_BTC, and Bybit Futures has BYBIF_USDT_ETHBTC, where the base is the composite ETHBTC. Composing a symbol from a pair name will work most of the time and then break on exactly these cases.
The reliable sources are:
-
The app’s address bar. Open the market in the trading terminal and copy the symbol from the URL after
/trade/. -
The exchange list in the API.
GET /exchangesreturns every supported exchange with itscode,name,is_futures,trading_enabledandsignal_bot_enabledflags. -
The Altrady MCP server. Its
list_exchangesandlist_marketstools return codes and symbols directly, which is the easiest route for AI assistants and scripts. See the MCP Server section of this help center.
Exchange codes
The codes are historical and do not always resemble the exchange’s current name. Coinbase is GDAX, OKX is OKEX, HTX is HUBI. A trailing F usually marks the futures venue of the same exchange.
| Code | Exchange |
|---|---|
BINA |
Binance |
BIFU |
Binance Futures |
BIUS |
Binance US |
BNGX |
BingX |
BNGXF |
BingX Futures |
BITMF |
BitMart |
BMEX |
BitMEX |
BVVO |
Bitvavo |
BYBI |
Bybit |
BYBIEU |
Bybit EU |
BYBIF |
Bybit Futures |
GDAX |
Coinbase |
CRO |
Crypto.com |
GATE |
Gate.io |
HUBI |
HTX |
HITB |
HitBTC |
HYPERLIQUID |
Hyperliquid |
HYPERLIQUIDF |
Hyperliquid Futures |
KRKN |
Kraken |
KRKNF |
Kraken Futures |
KUCN |
KuCoin |
KUCNF |
KuCoin Futures |
MEXC |
MEXC |
MEXCF |
MEXC Futures |
OKEX |
OKX |
OKEXF |
OKX Futures |
PLNX |
Poloniex |
TBITF |
Toobit |
WOO |
WOO X |
This list changes as exchanges are added or retired, so treat GET /exchanges as the source of truth rather than this table.
Where you use the symbol
-
Deep links.
https://app.altrady.com/dashboard#/d/BINA_USDT_BTCopens that market in the trading terminal. See the deep links article in this section. -
Trade setups.
POST /trade_setupstakes the market ascoinray_symbol. When a setup is sent to a signal provider for other exchanges, Altrady swaps only the exchange code and keeps the rest of the symbol, so the pair must exist under the same quote and base on the target exchange. - Webhooks and bots. Signal bot and TradingView webhook payloads identify the market by the same symbol.
-
Notes, alerts, and orders. Every API endpoint that takes a market accepts
coinray_symbol.
Still stuck?
If a symbol you built is rejected or opens the wrong market, send it to us through the support chat together with the pair and exchange you meant, and we will check it with you.