Глоссарий
Термины из обмена, API и правил сервиса CORE.
- Адрес возврата
- Адрес, на который вернется депозит, если обмен не завершится. Если он указан при создании, CORE отслеживает возврат. Без него порядок возврата определяет исполнитель.
- Адрес получения
- Адрес, на который клиент получит монеты. CORE проверяет, что он подходит сети получения, до создания заявки и до депозита.
- Актив и сеть
- Актив в CORE это всегда код и сеть: USDT в TRON и USDT в Ethereum это разные монеты. Оба поля есть в каждой котировке, сделке и проверке адреса.
- Дедлайн депозита
- Время, до которого депозит должен прийти по заявке у исполнителя. Отсчет начинается после создания заявки.
- Исполнитель (Executor)
- Компания, которая проводит обмен: принимает депозит, меняет монеты и отправляет выплату. CORE сравнивает исполнителей и создает заявку у лучшего. Депозит уходит на адрес исполнителя, а не CORE.
- Лимит запросов
- На каждый ключ API: 600 запросов в минуту на чтение (курсы, сделки) и 60 на создание обменов. Если сам ограничитель откажет, запросы отклоняются.
- Партнерская ссылка (ref)
- Публичный токен в ссылке или виджете партнера. Он только засчитывает обмен партнеру, в отличие от ключа API. Переход помнится 30 дней, засчитывается последний.
- Паспорт провайдера
- Что CORE знает об исполнителе. Показывается вместе с котировкой везде, где исполнитель назван: кто получает депозит, какие режимы курса он поддерживает, принимает ли адрес возврата при создании заявки, версия и ссылка его условий, каким сетям нужен memo, и история сделок CORE с ним. Неподтвержденные поля остаются пустыми.
- Плавающий курс
- Сумма до депозита ориентировочная. Итог фиксируется, когда депозит приходит. Все активные исполнители работают по плавающему курсу, поэтому курс заранее не гарантирован.
- Подтверждение обмена
- Документ по завершенной сделке: номер, статус, обе суммы, оба хеша транзакций и исполнитель. Скачивается со страницы отслеживания.
- Проверки AML / KYT
- Проверка происхождения средств и санкционных списков по депозиту. Ее проводит исполнитель по своим правилам, CORE своих проверок не ведет.
- Сделка (Deal)
- Котировка, которую приняли и исполняют. Так CORE называет то, что в других сервисах зовут свопом или ордером. От создания до итога сделка проходит шесть статусов.
- Срок действия котировки
- Время, до которого можно принять котировку. Дедлайн депозита начинается позже, после создания сделки, и считается отдельно.
- Ссылка отслеживания (trackUrl)
- Публичная страница сделки. Ссылка приходит в поле trackUrl каждого ответа о сделке. Доступ дает сама ссылка, аккаунт не нужен. На странице статус, хеши и форма обращения в поддержку.
- Статус сделки
- DRAFT и ACTIVE: сделка в работе. COMPLETED, FAILED, REFUNDED и EXPIRED: итоговые статусы, они больше не меняются. Каждый статус описан в справке API и на странице сделки.
- comparedExecutors
- Сколько исполнителей ответили на запрос котировки. Партнерский API отдает число без списка имен. Имена включаются на ключе партнера, который показывает сравнение своим пользователям.
- coreTrackRecord
- История сделок CORE с одним исполнителем: сколько проведено, завершено, завершилось ошибкой или возвратом, и среднее время исполнения. Если сделок с исполнителем не было, поле равно null.
- Idempotency-Key
- Обязательный заголовок запроса на создание сделки. Повтор с тем же ключом возвращает исходную сделку вместо новой, поэтому таймаут не приведет к повторному списанию.
- Memo (тег)
- Дополнительный идентификатор, который некоторые сети требуют вместе с адресом, чтобы зачислить монеты на нужный счет. Обязателен для таких активов, как XRP, XLM и TON. CORE проверяет его до создания заявки: выплату без memo вернуть нельзя.
- UNDER_REVIEW
- Шаг сделки, пока заявку у исполнителя подтверждают. Создание тогда отвечает 202: status ACTIVE, stage UNDER_REVIEW, адреса депозита нет. Ждите: оператор уточнит заявку у исполнителя до любых переводов.