> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spreader.sh/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Spreader is a web service that tracks arbitrage spreads between crypto exchanges. This documentation covers only what a user of the service sees and does.
> Page paths starting with /en/ are English. Translations live under /ru/ and /uk/ with the same file names.
> Screenshots are illustrations. Every screenshot is accompanied by text that states the same facts, so you do not need to see the image.

# Посилання на сторінку спреду

> Граматика адреси сторінки спреду /spread?long=exchange:type:NAME&short=exchange:type:NAME, дві форми назви маркету, кодування та що сервер робить із неточною адресою.

У кожної сторінки спреду є стабільна адреса, яку можна зібрати у власному програмному забезпеченні або боті. Граматику нижче також використовують бот Spreader і кожне посилання, яке пише сайт.

## Формат

```
/spread?long=<leg>&short=<leg>
leg = exchange:type:NAME
```

| Частина | Що це | Приклади |
| - | - | - |
| `exchange` | Код біржі з таблиці [Біржі](https://docs.spreader.sh/uk/exchanges/overview.md) | `binance`, `okx`, `bybit`, `gate`, `whitebit`, `hyperliquid`, `bybitfi`, `gatefi`, `binancedex` |
| `type` | Тип маркету | `spot`, `perp` (безстроковий контракт), `margin` (шорт на маржі, спотовий маркет із маржинальною торгівлею) |
| `NAME` | Назва маркету в одній із двох форм, див. нижче | `BTC/USDT`, `xyz:GOLD` |

Регістр не має значення для біржі, типу, монети та валюти котирування: `OKX:Perp:btc/usdt` і `okx:perp:BTC/USDT` — те саме. Порядок двох параметрів не має значення. `long` — нога, яку ви купуєте, `short` — нога, яку продаєте.

## Читабельна форма: `COIN/QUOTE`

Так зовнішнє програмне забезпечення збирає посилання і так сайт пише майже всі власні посилання. Монета та валюта котирування — **як їх називає біржа**, а не як Spreader називає актив: контракт на тисячу PEPE на Binance — це `1000PEPE/USDT`, а не `PEPE/USDT`, золото на Bybit TradFi — `XAUUSD+/USD`.

```
/spread?long=okx:perp:BTC/USDT&short=whitebit:margin:BTC/USDT
/spread?long=binance:perp:1000PEPE/USDT&short=gate:perp:PEPE/USDT
/spread?long=gate:spot:NEAR/USDT&short=okx:perp:NEAR/USDT
```

Валюту котирування можна опустити (`okx:perp:ETH`), коли монета має одну валюту котирування на цій біржі та типі. За кількох валют сторінка показує список для вибору.

## Точна форма: символ біржі

Назва маркету літера в літеру, як її називає біржа: `BTC-USDT-SWAP` на OKX, `xyz:GOLD` на builder DEX Hyperliquid, `PF_XBTUSD` на Kraken. Вона потрібна, коли читабельної форми недостатньо:

* **Близнюки**: у біржі два маркети одного типу для однієї монети та валюти котирування, наприклад `xyz:AAOI` і `para:AAOI` на Hyperliquid, `AAPLx/USD` і `AAPLSPV/USD` на Kraken, два токени Binance Alpha з одним тикером. Такі маркети сайт пише символом, щоб посилання завжди відкривало саме той маркет, на який ви натиснули.
* **Зняті з торгів маркети**: лише точна форма відкриває їхню сторінку з банером про делістинг і збереженою історією.

```
/spread?long=kraken:perp:PF_XBTUSD&short=okx:perp:BTC/USDT
/spread?long=bybitfi:perp:AAOI/USD&short=hyperliquid:perp:xyz:AAOI
```

## Кодування

`:` і `/` пишуться як є. Кодуються лише символи, заборонені в адресі: `&` → `%26`, пробіл → `%20`, `$` → `%24`, нелатинські літери — як UTF-8. `bybitfi:perp:AT&T/USD` стає `bybitfi:perp:AT%26T/USD`. Браузери роблять це самі. У коді використовуйте стандартний кодувальник компонента URL і поверніть `:` та `/` назад.

## Що сервер робить із набраною адресою

Сервер не вгадує. Для кожної ноги, у межах біржі та типу (для `margin` — серед спотових маркетів із маржинальною торгівлею):

1. **Точна назва.** Якщо `NAME` дорівнює символу маркету, це той маркет, у будь-якому статусі (саме так відкриваються зняті з торгів маркети). Якщо `NAME` містить `/`, частина до останнього `/` дорівнює символу, а частина після — його валюті котирування, це також той маркет (`hyperliquid:perp:xyz:GOLD/USDC`).
2. **За монетою та валютою котирування** серед торгованих маркетів і тих, що знімаються з торгів: частина до останнього `/` — монета, після — валюта котирування. Рівно один маркет: цей. Кілька: сторінка **Нозі long підходять кілька маркетів — оберіть:** із точним посиланням на кожного кандидата. Жодного: **Нозі long не підходить жоден маркет. Монета котирується там у …** з валютами котирування, які монета має на цій біржі.
3. **Без валюти котирування** (`okx:perp:ETH`): одна валюта — цей маркет. Кілька — список.

Пара загалом має бути двома різними маркетами одного активу в дозволеному типі: спот лише як нога лонг, маржа лише як нога шорт, спот проти споту лише на різних біржах. Інакше сторінка показує **Ноги належать різним активам**, **Обидві ноги вказують на один маркет** або **Не вдалося розібрати ногу long**, ніколи не порожній екран. Адреса, яку взагалі не вдається прочитати, включно зі старою формою `/spread?p=…`, відкриває сканер.

## Як сайт пише власні посилання

Кожен об’єкт маркету, який сайт надсилає в браузер, несе готовий токен ноги: читабельну форму, коли маркет не має близнюка серед торгованих маркетів того ж типу, монети та валюти котирування, і символ в іншому разі. Коли ви відкриваєте пару натисканням без посилання (пошук, Конструктор пари, клавіші зі стрілками), сторінка замінює адресу в браузері на читабельну форму без запису в історії, тож скопійована адреса завжди однакова.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.