Welcome to our new support center!
We provide 24x7 support by human agents! So if our documentation can’t help you out, feel free to reach out and create a ticket!

Altrady Support Altrady Support

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:

  1. The app’s address bar. Open the market in the trading terminal and copy the symbol from the URL after /trade/.
  2. The exchange list in the API. GET /exchanges returns every supported exchange with its code, name, is_futures, trading_enabled and signal_bot_enabled flags.
  3. The Altrady MCP server. Its list_exchanges and list_markets tools 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_BTC opens that market in the trading terminal. See the deep links article in this section.
  • Trade setups. POST /trade_setups takes the market as coinray_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.

Was this article helpful?