# iEXExchanger API

> Публичный API некастодиального крипто-кошелька для обменников: депозиты, выплаты, webhooks.

## Docs

- [AML по депозиту: получить результат скрина](https://wallet-docs.iexexchanger.com/aml/deposit-checks.md): Получить AML-данные депозита (source-of-funds) по его uuid или по вашему order_id, понять поведение hold
- [AML-скрин: проверка адресов и транзакций](https://wallet-docs.iexexchanger.com/aml/overview.md): iEXWallet AML: запуск скрина риска по требованию, опрос результата и список валют через те же API-ключи
- [AML: уровни риска и статусы](https://wallet-docs.iexexchanger.com/aml/risk-levels.md): Как трактовать status, riskLevel, riskScore, decision и signals в ответах AML
- [Запустить AML-скрин адреса или транзакции](https://wallet-docs.iexexchanger.com/api-reference/public-·-aml/запустить-aml-скрин-адреса-или-транзакции.md): Скринит адрес (по умолчанию) или транзакцию через подключённого AML-провайдера и возвращает риск-скор/уровень. Результат может быть `pending` — тогда опрашивайте GET /v1/public/aml/checks/{uuid}. Идемпотентно по X-Idempotency-Key (повтор не тратит лишнюю квоту провайдера).
- [Получить результат AML-проверки](https://wallet-docs.iexexchanger.com/api-reference/public-·-aml/получить-результат-aml-проверки.md): Опрашивает результат по uuid. Если ещё pending — дёргает провайдера и реконсилит статус.
- [Список валют, доступных для AML-скрина](https://wallet-docs.iexexchanger.com/api-reference/public-·-aml/список-валют-доступных-для-aml-скрина.md): Валюты, которые можно передать в POST /v1/public/aml/checks (allowlist подключённого AML-провайдера). Пустой список = провайдер ещё не синхронизировал валюты (скрин всё равно возможен, но неподдерживаемое вернётся как skipped).
- [List supported currencies](https://wallet-docs.iexexchanger.com/api-reference/public-·-assets/list-supported-currencies.md): Возвращает список активных валют, которые обменник может использовать для депозитов и выплат. Только публичные поля (код, тикер, сеть, стандарт токена, decimals, флаги deposit/payout, адрес контракта, минимальные суммы).
- [Доступные балансы по активам](https://wallet-docs.iexexchanger.com/api-reference/public-·-balances/доступные-балансы-по-активам.md): Агрегированные доступные средства hot-кошельков по каждому активу — то, чем можно оплачивать выплаты. Возвращает массив { assetCode, symbol, network, available, updatedAt }.
- [Живая котировка конвертации (preview)](https://wallet-docs.iexexchanger.com/api-reference/public-·-conversions/живая-котировка-конвертации-preview.md): Возвращает ожидаемый выход, minReceived, курс и slippage для пары source→target. Не создаёт заявку. `executable=false` = провайдер отдал preview-курс без on-chain исполнения (не настроен DEX-backend).
- [Создать конвертацию](https://wallet-docs.iexexchanger.com/api-reference/public-·-conversions/создать-конвертацию.md): Создаёт заявку на своп накопленного актива в стейбл. Исполняется асинхронно — опрашивайте GET /v1/public/conversions/{uuid}. Идемпотентно по X-Idempotency-Key.
- [Статус конвертации](https://wallet-docs.iexexchanger.com/api-reference/public-·-conversions/статус-конвертации.md)
- [Create new deposit request](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/create-new-deposit-request.md): Создаёт депозит и возвращает адрес (+ memo для memo-based сетей) для оплаты. Идемпотентно по (site, order_id, asset) и опц. X-Idempotency-Key.
- [Get AML data for deposit by uuid](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/get-aml-data-for-deposit-by-uuid.md): AML-скрин source-of-funds (адрес отправителя входящей tx) по депозиту. amlStatus=not_checked если AML выключен / tx ещё не замечена / сеть не поддерживается провайдером.
- [Get AML data for deposit by your order_id](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/get-aml-data-for-deposit-by-your-order_id.md): AML-скрин source-of-funds депозита по вашему order_id (label).
- [Get deposit by uuid (scoped to caller siteId)](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/get-deposit-by-uuid-scoped-to-caller-siteid.md): Возвращает депозит + on-chain данные incoming-tx (object `transaction`, null если tx ещё нет).
- [Get deposit by your order_id](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/get-deposit-by-your-order_id.md): Поиск по вашему order_id (label). Возвращает депозит + on-chain данные incoming-tx.
- [List deposits (paginated, scoped to caller siteId)](https://wallet-docs.iexexchanger.com/api-reference/public-·-deposits/list-deposits-paginated-scoped-to-caller-siteid.md): История депозитов сайта. Пагинация page/perPage, опц. фильтр ?status=paid или ?status=paid,paid_over.
- [Create invoice (payment link) — for exchanger CMS](https://wallet-docs.iexexchanger.com/api-reference/public-·-invoices/create-invoice-payment-link-—-for-exchanger-cms.md): Создаёт счёт для вызывающего сайта и возвращает ссылку оплаты (payPath + token). При оплате существующий вебхук `deposit.finalized` уйдёт на callback_url сайта с вашим order_id. Статус также можно опрашивать через GET /v1/public/invoices/{token}.
- [Get invoice payment page by public token](https://wallet-docs.iexexchanger.com/api-reference/public-·-invoices/get-invoice-payment-page-by-public-token.md): Данные платёжной страницы: адрес, актив, сумма, срок (отсчёт), статус оплаты, бренд. 410 Gone если ссылка отключена (прошёл срок + 1 день).
- [Poll invoice payment status](https://wallet-docs.iexexchanger.com/api-reference/public-·-invoices/poll-invoice-payment-status.md): Лёгкий статус для live-обновления страницы (поллинг каждые ~3с). 410 если ссылка отключена.
- [List supported networks](https://wallet-docs.iexexchanger.com/api-reference/public-·-networks/list-supported-networks.md): Возвращает список включённых сетей с метаданными: код, название, архетип, нативный тикер, флаг enabled, число подтверждений по умолчанию.
- [Create payout request](https://wallet-docs.iexexchanger.com/api-reference/public-·-payouts/create-payout-request.md): Создаёт выплату на указанный адрес. Идемпотентно по (site, order_id) и опц. X-Idempotency-Key. Может потребовать ручного одобрения (requiresApproval=true).
- [Estimate network fee for payout (без создания)](https://wallet-docs.iexexchanger.com/api-reference/public-·-payouts/estimate-network-fee-for-payout-без-создания.md)
- [Get payout by uuid (scoped to caller siteId)](https://wallet-docs.iexexchanger.com/api-reference/public-·-payouts/get-payout-by-uuid-scoped-to-caller-siteid.md): Возвращает выплату + on-chain данные исходящей tx (txHash, confirmations, explorerTxUrl, timestamps).
- [Get payout by your order_id](https://wallet-docs.iexexchanger.com/api-reference/public-·-payouts/get-payout-by-your-order_id.md): Поиск по вашему order_id (label). Возвращает выплату + on-chain данные исходящей tx.
- [List payouts (paginated, scoped to caller siteId)](https://wallet-docs.iexexchanger.com/api-reference/public-·-payouts/list-payouts-paginated-scoped-to-caller-siteid.md): История выплат сайта. Пагинация page/perPage, опц. фильтр ?status=confirmed или ?status=queued,broadcasted.
- [Отправить тестовый webhook на ваш callback_url](https://wallet-docs.iexexchanger.com/api-reference/public-·-webhooks/отправить-тестовый-webhook-на-ваш-callback_url.md): Ставит в очередь один (без ретраев) подписанный тестовый webhook на настроенный для сайта callback_url. Заголовки и подпись — как у боевых webhook'ов (X-Signature = HMAC-SHA256 по телу). Проверьте, что ваш endpoint принял его и валидировал подпись.
- [Переотправить webhook по X-Event-Id](https://wallet-docs.iexexchanger.com/api-reference/public-·-webhooks/переотправить-webhook-по-x-event-id.md): Ставит в очередь повторную доставку ранее сгенерированного webhook'а (по его X-Event-Id). Тело и URL берутся из лога доставки; подпись пересчитывается. Скоупится по вашему сайту.
- [Аутентификация](https://wallet-docs.iexexchanger.com/authentication.md): Подпись запросов HMAC-SHA256, проверка времени и IP-whitelist
- [Конвертации — обмен активов в стейбл](https://wallet-docs.iexexchanger.com/conversions/overview.md): Своп накопленных активов (ETH, LINK…) в стейбл через те же API-ключи: котировка, создание, статус
- [Статусы конвертаций](https://wallet-docs.iexexchanger.com/conversions/statuses.md): Жизненный цикл свопа: от очереди до зачисления стейбла
- [Валюты, сети и балансы](https://wallet-docs.iexexchanger.com/currencies.md): Справочники assets, networks и balances — поля и примеры
- [Депозиты — приём платежей](https://wallet-docs.iexexchanger.com/deposits/overview.md): Создание депозита, отслеживание, AML-скрин, примеры запросов и ответов
- [Статусы депозита](https://wallet-docs.iexexchanger.com/deposits/statuses.md): Полный жизненный цикл депозита, on-chain статусы и связь с webhooks
- [Окружения](https://wallet-docs.iexexchanger.com/environments.md): Base URL, IP-whitelist, sandbox и продакшен, health-проверка
- [Ошибки](https://wallet-docs.iexexchanger.com/errors.md): Единый формат ответа, маппинг HTTP-статусов и полный справочник кодов ошибок
- [Частые вопросы](https://wallet-docs.iexexchanger.com/faq.md): Подписи, время, идемпотентность, суммы, memo/TON, тестирование webhooks, IP-whitelist и ротация ключей
- [Идемпотентность](https://wallet-docs.iexexchanger.com/idempotency.md): Безопасные повторы запросов без дубликатов: order_id и X-Idempotency-Key
- [Введение](https://wallet-docs.iexexchanger.com/introduction.md): Публичный API некастодиального крипто-кошелька для приёма депозитов и отправки выплат
- [Счета — выставление платёжной ссылки](https://wallet-docs.iexexchanger.com/invoices/overview.md): Создать счёт по API: клиент получает hosted-страницу оплаты с адресом, QR, обратным отсчётом и статусом в реальном времени
- [Выплаты — отправка платежей](https://wallet-docs.iexexchanger.com/payouts/overview.md): Оценка комиссии, создание выплаты и отслеживание статуса — запросы, ответы и поля
- [Статусы выплаты](https://wallet-docs.iexexchanger.com/payouts/statuses.md): Полный жизненный цикл выплаты, on-chain статусы и срабатывание вебхуков
- [Быстрый старт](https://wallet-docs.iexexchanger.com/quickstart.md): От API-ключа до пойманного webhook — за несколько минут
- [Лимиты запросов](https://wallet-docs.iexexchanger.com/rate-limits.md): Throttling: глобальный и per-site лимиты, поведение 429 и стратегия повторов
- [Webhooks](https://wallet-docs.iexexchanger.com/webhooks/overview.md): Исходящие webhook'и: заголовки, проверка подписи, типы событий, политика повторов и эндпоинты test/resend

## OpenAPI Specs

- [openapi-public](https://wallet-docs.iexexchanger.com/openapi-public.json)