---
title: Exchange & Symbol Format
description: >-
  Complete list of supported exchanges and their symbol format syntax for use in
  kScript.
---

<div class="flex gap-3 mb-6">
  <span class="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-green-50 text-green-600 text-sm font-medium">
    Reference
  </span>
  <span class="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-gray-100 text-gray-600 text-sm font-medium">
    3 min read
  </span>
</div>

## Exchange Symbol Formats

When using data source functions like `ohlcv()` or `source()`, you need to specify the symbol in the correct format for each exchange. Below is a comprehensive list of all supported exchanges and their respective symbol formats.

### Example Usage

```javascript title="Multi-Exchange Comparison" lines wrap
//@version=2
define(title="Multi-Exchange Comparison", position="offchart", axis=true);

// Binance Spot (no separator)
timeseries binanceSpot = ohlcv(symbol="BTCUSDT", exchange="BINANCE");

// Binance Futures (no separator)
timeseries binanceFutures = ohlcv(symbol="BTCUSDT", exchange="BINANCE_FUTURES");

// Coinbase (uses hyphen)
timeseries coinbase = ohlcv(symbol="BTC-USD", exchange="COINBASE");

// Plot comparison
plotLine(value=binanceSpot.close, width=2, colors=["#F3BA2F"], label=["Binance Spot"], desc=["BTCUSDT on Binance Spot"]);
plotLine(value=binanceFutures.close, width=2, colors=["#FF6B35"], label=["Binance Futures"], desc=["BTCUSDT on Binance Futures"]);
plotLine(value=coinbase.close, width=2, colors=["#0052FF"], label=["Coinbase"], desc=["BTC-USD on Coinbase"]);
```

## Exchange Reference Table

| Exchange | Category | Symbol Format | Example |
|----------|----------|---------------|---------|
| `BINANCE` | SPOT | `BTCUSDT` | Bitcoin to Tether (Spot) |
| `BINANCE_FUTURES` | PERPETUAL | `BTCUSDT` | BTC/USDT Perpetual |
| `BITFINEX` | SPOT | `BTCUST` or `BTC:USD` | Bitcoin to USD (Spot) |
| `BITFINEX_DERIVATIVES` | PERPETUAL | `BTCF0:USTF0` | BTC Perpetual |
| `BITMEX` | PERPETUAL | `XBTUSD` | Bitcoin to USD |
| `BITSTAMP` | SPOT | `BTCUSD` | Bitcoin to USD (Spot) |
| `BYBIT` | PERPETUAL | `BTCUSDT` | BTC/USDT Perpetual |
| `BYBIT_SPOT` | SPOT | `BTCUSDT` | Bitcoin to USDT (Spot) |
| `COINBASE` | SPOT | `BTC-USD` | Bitcoin to USD (Spot) |
| `DERIBIT` | SPOT | `BTC_USDT` | Bitcoin to USDT (Spot) |
| `DERIBIT` | PERPETUAL | `BTC-PERPETUAL` | BTC/USD Perpetual |
| `DERIBIT` | PERPETUAL | `BTC_USDC-PERPETUAL` | BTC/USDC Perpetual |
| `GATE_IO` | SPOT | `BTC_USDC` | Bitcoin to USDC (Spot) |
| `GATE_IO_FUTURES` | PERPETUAL | `BTC_USDT` | BTC/USDT Perpetual |
| `HYPERLIQUID` | SPOT | `HYPE-USDC` | HYPE to USDC (Spot) |
| `HYPERLIQUID_FUTURES` | PERPETUAL | `BTC` | BTC Perpetual |
| `OKEX` | SPOT | `BTC-USDT` | Bitcoin to USDT (Spot) |
| `OKEX_FUTURES` | FUTURE | `BTC-USDT-251226` | BTC Future (Dec 26, 2025) |
| `OKEX_SWAP` | PERPETUAL | `BTC-USDT-SWAP` | BTC/USDT Perpetual Swap |
| `OKEX_OPTIONS` | OPTION | `BTC-USD-YYMMDD-STRIKE-C/P` | BTC Option (Call/Put) |
| `UPBIT` | SPOT | `KRW-USDT` | Korean Won to USDT |

## Important Notes

{% hint style="warning" %}
**Case Sensitivity**

Exchange names are **case-sensitive**. Always use uppercase for exchange names (e.g., `BINANCE`, not `binance`).
{% endhint %}

{% hint style="info" %}
**Symbol Format Variations**

Different exchanges use different separators: hyphens (`-`), underscores (`_`), colons (`:`), or no separator at all. Always check the format for your specific exchange.
{% endhint %}

{% hint style="success" %}
**Data Availability**

Not all data types are available for every exchange and symbol combination. If there's an exchange, symbol or data source you'd like us to support, feel free to request it on our Discord community!
{% endhint %}

{% hint style="info" %}
**Futures and Options Format**

For dated futures and options, use the format specified by the exchange. For example, `YYMMDD` represents the year, month, and day of expiry.
{% endhint %}