SwapZilla Partner API

Проверяет, что ключ рабочий, и говорит, кто вы. Сам ключ в ответе не возвращается.

curl -s https://api.swapzilla.io/v1/partner/me \
  -H "X-API-Key: $API_KEY"

{
  "ID": "12ec0f35-2f4a-4c0e-9f1b-7d0a9e5a1c33",
  "Name": "Acme Inc",
  "Enabled": true,
  "CreatedAt": "2026-05-04T12:59:13Z",
  "UpdatedAt": "2026-05-04T12:59:13Z"
}

Без заголовка — 401 и {"error":"missing X-API-Key header"}; с неизвестным ключом — 401 и {"error":"invalid api key"}. Если ключ нам известен, но работать ему нельзя — не активирован, отклонён или отозван — то 403, и в тексте сказано, что именно. Это разные вещи: 401 — «перепроверьте ключ», 403 — «ключ верный, напишите в поддержку».

Опрашивает все включённые провайдеры параллельно и возвращает их офферы. Провайдер, который упал или не успел, просто отсутствует в списке.

Параметры запроса

Ответ

{
  "offers": [
    {
      "ID": "0b0c8f0e-2c1a-4f3f-8f57-2a1d1c4e77aa",
      "ProviderCode": "fixedfloat",
      "ProviderName": "FixedFloat",
      "RateType": "floating",
      "FromAsset": "BTC",
      "FromNetwork": "BTC",
      "ToAsset": "USDT",
      "ToNetwork": "TRX",
      "FromAmount": 0.05,
      "ToAmount": 3920.55,
      "AmountFromUsd": 3940.15,
      "AmountToUsd": 3919.57,
      "Price": 78411.08,
      "EstimatedMins": 6,
      "KycRating": "B",
      "DeviationPercent": 0,
      "MinFromAmount": 0.00064584,
      "MaxFromAmount": 7.10422758,
      "CreatedAt": "2026-08-18T09:12:44Z"
    }
  ]
}

Поля оффера, которые важны

Тот же запрос, но потоком. Офферы приходят по мере ответа каждого провайдера, а не после самого медленного — первый обычно за 200–400 мс. Именно это нужно живому интерфейсу.

Параметры те же, что у /quotes, плюс timeout_ms — по умолчанию и максимум 5000 мс. Стрим всегда закрывается сам.

События

// С вашего бэкенда, который добавляет ключ. В браузере — только через прокси.
const res = await fetch(url, { headers: { "X-API-Key": key, Accept: "text/event-stream" } });
const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
// … делите по "\n\n", разбирайте строки "event:" / "data:", рисуйте каждый `offer` сразу

Превращает оффер в реальный ордер у провайдера. Отвечает 201 и полным ордером.

Тело запроса

Ответ

{
  "ID": "7a0e2c31-4f9a-4b2e-9a77-9f0b2e5d1c02",
  "ProviderCode": "fixedfloat",
  "ProviderOrderID": "FF9K2LQ",
  "OfferID": "0b0c8f0e-2c1a-4f3f-8f57-2a1d1c4e77aa",
  "Status": "NEW",
  "FromAsset": "BTC",
  "ToAsset": "USDT",
  "FromNetwork": "BTC",
  "ToNetwork": "TRX",
  "DepositAddress": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
  "PayoutAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "RefundAddress": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
  "AmountFrom": 0.05,
  "AmountFromExpected": 0.05,
  "AmountToExpected": 3920.55,
  "AmountToReceived": 0,
  "RateType": "floating",
  "TxID": "",
  "PartnerID": "12ec0f35-2f4a-4c0e-9f1b-7d0a9e5a1c33",
  "CreatedAt": "2026-08-18T09:13:02Z",
  "UpdatedAt": "2026-08-18T09:13:02Z"
}

Текущее состояние вашего ордера. Чужой ордер отвечает 404, а не 403.

Мы сами опрашиваем провайдера каждые 10 секунд по всем ордерам в нетерминальном статусе, поэтому вам достаточно опрашивать этот эндпоинт раз в 5–10 секунд — ходить к провайдеру напрямую не нужно.

Ваши ордера, новые сверху. page по умолчанию 1, limit — 20 и не больше 100.

curl -s "https://api.swapzilla.io/v1/partner/orders?page=1&limit=50" \
  -H "X-API-Key: $API_KEY"

{ "orders": [ /* … */ ], "page": 1, "limit": 50, "has_more": true }

Синхронно ходит к провайдеру и возвращает обновлённый ордер — статус, фактические суммы и TxID. Полезно сразу после того, как пользователь сказал «я отправил». Не чаще раза в 5 секунд: фоновый поллер и так делает эту работу.

Параметры пары те же, что у /quotes, плюс max_routes (положительное целое). Возвращает {"routes": [ … ]}; в каждом маршруте есть LegA и LegB — оба обычные офферы — и собственные AmountTo, EstimatedMins, KycRating, DeviationPercent.

curl -sG "https://api.swapzilla.io/v1/partner/private-quotes" \
  -H "X-API-Key: $API_KEY" \
  --data-urlencode "from_asset=TRX" \
  --data-urlencode "from_network=TRX" \
  --data-urlencode "to_asset=USDT" \
  --data-urlencode "to_network=ERC20" \
  --data-urlencode "amount_from=100" \
  --data-urlencode "max_routes=5"

Стриминговый близнец — /v1/partner/private-quotes-sse: те же параметры плюс timeout_ms, события route, provider_error, ping и done.

curl -s -X POST "https://api.swapzilla.io/v1/partner/private-orders" \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "route_id": "9d2f1a76-6c3b-4a55-b0f1-2c9a7e0d4411",
    "to_address": "0x750c44dB01899176f2e64bD25A2fabAC1140d8e9",
    "refund_address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "intermediate_refund_address": "48jLd5…"
  }'

Отвечает 201 и объектом PrivateSwap, внутри которого FirstOrder и SecondOrder. Показывать пользователю нужно FirstOrder.DepositAddress.

Агрегированный статус и обе ноги целиком — этого хватает на подробный таймлайн в интерфейсе. GET /v1/partner/private-orders отдаёт список ваших с той же пагинацией page / limit, что и обычные ордера.

Все доступные активы и сети с провайдерами, которые их поддерживают, — источник правды для селектора валют. Отфильтровано до топ-100 по капитализации, обновляется раз в несколько часов.

{ "assets": [ { "Code": "BTC", "Network": "BTC", "Providers": ["fixedfloat", "changee"] } ] }

Зарегистрированные обменники с человекочитаемыми именами и признаком, включён ли провайдер сейчас.

{ "providers": [ { "code": "changee", "name": "Changee", "enabled": true } ] }

Проверяет адрес по формату сети до того, как пользователь нажмёт «отправить». Параметры network и address; без них — 400.

curl -sG "https://api.swapzilla.io/v1/validate-address" \
  --data-urlencode "network=ERC20" \
  --data-urlencode "address=0x750c44dB01899176f2e64bD25A2fabAC1140d8e9"

{ "valid": true, "network": "ERC20", "known": true }

known: false значит, что паттерна для этой сети у нас нет и проверка ничего не доказала — это «не проверено», а не «валидно».

Лучший курс по каждому направлению в XML-формате для мониторингов (BestChange-style), пересобирается раз в несколько секунд и кэшируется. На сайте опубликован как /export/rates.xml. Коды валют — по конвенции мониторингов: USDT в сети Tron это USDTTRC20.

<rates>
  <item>
    <from>BTC</from>
    <to>USDTTRC20</to>
    <in>1</in>
    <out>63684.46973</out>
    <minamount>0.00078071</minamount>
    <maxamount>1.17106129</maxamount>
    <param>floating</param>
  </item>
</rates>