Trocador.

Этот метод возвращает все монеты, перечисленные в нашей базе данных, с их названиями, тикерами, сетями, минимальными и максимальными суммами для обмена. Вы можете использовать этот метод для наполнения своей базы данных, как вариант, вы можете использовать эти данные при создании транзакций.

• Параметры:
  

• Примеры:
  - https://trocador.app/api/coins

• Результаты:
  - name: название монеты;
  - ticker: тикер монеты;
  - network: сеть монеты;
  - memo: использует ли монета мемо/дополнительный идентификатор. True или False;
  - image: значок монеты;
  - minimum: минимальная сумма на которую можно совершать обмен;
  - maximum: максимальная сумма на которую можно совершать обмен;

Этот метод возвращает все данные по монетам, которые имеют указанное название или тикер. В случае, если несколько монет имеют один и тот же тикер, метод возвращает список со всеми монетами. По крайней мере, тикер или имя являются обязательными.

• Параметры:
  - ticker: тикер монеты, которую вы хотите получить, например, btc (необязательно);
  - name: название монеты, которую вы хотите получить, например, Bitcoin (необязательно);

• Примеры:
  - https://trocador.app/api/coin?ticker=btc
  - https://trocador.app/api/coin?name=Bitcoin

• Результаты:
  - name: название монеты;
  - ticker: тикер монеты;
  - network: сеть монеты;
  - memo: использует ли монета мемо/дополнительный идентификатор. True или False;
  - image: значок монеты;
  - minimum: минимальная сумма для сделки;
  - maximum: максимальная сумма для сделки;

Этот метод возвращает конкретную транзакцию с указанным в запросе идентификатором. Может использоваться для отображения обновленного статуса транзакции. Это возможно только в том случае, если данные о транзакциях все еще хранятся в нашей базе данных. По истечению 14 дней или по запросу пользователя данные о транзакциях удаляются для защиты конфиденциальности пользователя.

• Параметры:
  - id: строка или номер идентификатора транзакции (необязательно);

• Примеры:
  - https://trocador.app/api/trade?id=ID

• Результаты:
  - trade_id: ваш торговый идентификатор;
  - date: дата и время создания;
  - ticker_from: тикер монеты, которая будет продана;
  - ticker_to: тикер монеты, которую нужно купить;
  - coin_from: наименование монеты, которую нужно продать;
  - coin_to: наименование монеты, которую нужно купить;
  - network_from: сеть для монет, которые будут проданы;
  - network_to: сеть для монет, которые нужно купить;
  - amount_from: количество монет, которые будут проданы;
  - amount_to: количество монет, которые нужно купить;
  - provider: выбранный обмен;
  - fixed: True, если фиксированная ставка, False, если плавающая ставка;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес для получения купленных монет;
  - address_user_memo: адрес с мемо/дополнительным идентификатором для получения купленных монет;
  - refund_address: адрес, по которому при необходимости можно получить возврат;
  - refund_address_memo: адрес с мемо/дополнительным идентификатором, по которому при необходимости можно получить возврат;
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - quotes:
   support: вспомогательные данные о сервисе;
   expiresAt: дата и время истечения срока действия обмена;
  - details:
   hashout: хэш платежной транзакции. Будет доступен только после окончания сделки;
  - payment: True или False, в зависимости от того, стандартный ли это обмен или платеж;

Этот метод проверяет, можно ли использовать данный адрес с определенной монетой. Если вы не хотите проверять каждый адрес, в этом нет необходимости, поскольку система всегда выполняет эту проверку перед созданием очередной транзакции. Эта функция возвращает значение True или False в зависимости от того, соответствует ли указанный адрес выбранной монете и сети.

• Параметры:
  - ticker: тикер монеты, которую вы хотите протестировать, т.е. btc (обязательно);
  - network: сеть монеты, которую вы хотите протестировать, т.е. Основная сеть (обязательно);
  - address: адрес монеты, которую вы хотите протестировать (Обязательно);

• Примеры:
  - https://trocador.app/api/validateaddress?ticker=&network=&address=

• Результаты:
  - result: True, если адрес действителен, если нет, False;

Этот метод создает список котировок от всех поставщиков и упорядочивает их от наилучшего к наихудшему. Наряду с котировками указывается потенциальная оценка KYC для каждого обменного сервиса или биржи, от A (без KYC) до D (может удерживать средства пользователя на неопределенный срок на время верификации). Этот метод возвращает уникальный идентификатор, который вы должны использовать, если хотите создать транзакцию.

• Параметры:
  - ticker_from: тикер монеты, которую вы хотите продать, например, btc (обязательно);
  - network_from: выбор сети, в которой вы хотите продать монеты, например, Основная сеть (обязательно);
  - ticker_to: тикер монеты, которую вы хотите купить, например, xmr (обязательно);
  - network_to: выбор сети, в которой вы хотите купить монеты, например, Основная сеть (обязательно);
  - amount_from or amount_to: количество монет, которое вы хотите продать или получить (amount_from обязательно для стандартных обменов, а amount_to обязательно для платежей);
  - payment: True или False, в зависимости от того, хотите ли вы создать платеж с фиксированной ставкой или стандартный обмен (необязательно);
  - min_kycrating: если вы хотите монету только с сервиса или биржи с минимальным рейтингом A, B, C или D KYC, укажите этот параметр (необязательно);
  - min_logpolicy: если вы хотите получить монету только с сервиса или биржи с минимальным рейтингом ведения журнала A, B, C или D, укажите этот параметр (необязательно);
  - markup: мы позволяем партнерам указывать свои собственные комиссии в процентах (необязательно); это должно быть либо 0, 1, 1,65 или 3 (как %); если партнер предоставляет наценку=0 или вообще не предоставляет этот параметр, то Trocador разделит свою свою комиссии с партнером; имейте в виду, что при установке наценки > 0 конечному пользователю будут предложены более высокие котировки, поэтому цены вырастут по сравнению с теми, что предлагаются на главной странице Trocador;
  - best_only: если вы хотите узнать только наилучшую ставку для заданных параметров, укажите True (необязательно);

• Примеры:
  - https://trocador.app/api/new_rate?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=

• Результаты:
  - trade_id: ваш торговый идентификатор;
  - date: дата и время создания;
  - ticker_from: тикер монеты, которая будет продана;
  - ticker_to: тикер монеты, которую нужно купить;
  - coin_from: наименование монеты, которую нужно продать;
  - coin_to: наименование монеты, которую нужно купить;
  - network_from: сеть для монет, которые будут проданы;
  - network_to: сеть для монет, которые нужно купить;
  - amount_from: количество монет, которые будут проданы;
  - amount_to: количество монет, которые нужно купить;
  - provider: обмен по самому выгодному курсу;
  - fixed: тип котировки для наилучшего тарифа. True для фиксированного, False для плавающего;
  - status: статус сделки;
  - quotes: список всех других сгенерированных котировок с указанием их рейтинга KYC и потерь в процентном соотношении;
  - payment: True или False, в зависимости от того, стандартный ли это обмен или платеж;

Этот метод создает транзакцию с уникальным идентификатором для выбранной обменной операции и типа котировки. Он возвращает адрес сервиса полученный от поставщика, куда пользователь должен отправить свои монеты, чтобы получить запрошенную сумму.

• Параметры:
  - id: идентификационный номер ранее сгенерированной котировки (необязательно); если партнер не предоставит идентификатор ранее созданного метода new_rate, то транзакция будет создана с наилучшей ставкой, найденной среди оставшихся параметров, как если бы она была создана с параметром best_only метода new_rate;
  - ticker_from: тикер монеты, которую вы хотите продать, например, btc (обязательно);
  - network_from: выбор сети, в которой вы хотите продать монеты, например, Основная сеть (обязательно);
  - ticker_to: тикер монеты, которую вы хотите купить, например, xmr (обязательно);
  - network_to: выбор сети, в которой вы хотите купить монеты, например, Основная сеть (обязательно);
  - amount_from or amount_to: количество монет, которое вы хотите продать или получить (amount_from обязательно для стандартных обменов, а amount_to обязательно для платежей);
  - address: адрес, на который пользователь хочет получить свои монеты (обязательно);
  - address_memo: мемо/дополнительный идентификатор адреса, на который пользователь хочет получать свои монеты (если получаемая монета использует мемо/дополнительный идентификатор - используйте '0' для отказа от мемо);
  - refund: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы (необязательно);
  - refund_memo: мемо/дополнительный идентификатор адреса, на который пользователь хочет получить обратно свои монеты в случае возникновения проблем (если применяется возврат и отправленная монета использует мемо/дополнительный идентификатор - используйте '0' для отказа от мемо);
  - provider: приоритет обмена (обязательно);
  - fixed: True для фиксированной котировки, False для плавающей (обязательно);
  - payment: True или False, в зависимости от того, хотите ли вы создать платеж с фиксированной ставкой или стандартный обмен (необязательно);
  - min_kycrating: если вы хотите монету только с сервиса или биржи с минимальным рейтингом A, B, C или D KYC, укажите этот параметр (необязательно);
  - min_logpolicy: если вы хотите получить монету только с сервиса или биржи с минимальным рейтингом ведения журнала A, B, C или D, укажите этот параметр (необязательно);
  - webhook: если вы укажете в этом параметре URL-адрес, то каждый раз, когда статус транзакции измениться, вы будете получать POST-запрос, отправляющий вам новые данные о транзакции. Данный функционал позволяет избежать необходимости многократно обращаться к нашему серверу для проверки статуса транзакции (необязательно);
  - markup: мы позволяем партнерам указывать свои собственные комиссии в процентах (необязательно); должен быть либо 0, 1, 2 или 3%; если партнер предоставляет наценку=0 или вообще не предоставляет этот параметр, то Trocador будет делить половину своей комиссии с партнером; имейте в виду, что при установке наценки > 0 конечному пользователю будут предложены более высокие котировки, поэтому цены вырастут по сравнению с ценами, предлагаемыми на главной странице Trocador;

• Примеры:
  - https://trocador.app/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=
  - https://trocador.app/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=&refund=

• Результаты:
  - trade_id: ваш торговый идентификатор;
  - date: дата создания;
  - ticker_from: тикер монеты, которая будет продана;
  - ticker_to: тикер монеты, которую нужно купить;
  - coin_from: наименование монеты, которую нужно продать;
  - coin_to: наименование монеты, которую нужно купить;
  - network_from: сеть для монет, которые будут проданы;
  - network_to: сеть для монет, которые нужно купить;
  - amount_from: количество монет, которые будут проданы;
  - amount_to: количество монет, которые нужно купить;
  - provider: выбранный обмен;
  - fixed: True, если фиксированная ставка, False, если плавающая ставка;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес для получения купленных монет;
  - address_user_memo: адрес с мемо/дополнительным идентификатором для получения купленных монет;
  - refund_address: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - refund_address_memo: мемо/дополнительный идентификатор адреса, по которому пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - payment: True или False, в зависимости от того, стандартный ли это обмен или платеж;

Получите все доступные для продажи предоплаченные карты. Теперь вы можете получать доход, продавая предоплаченные карты Visa и Mastercard в USD и EUR, которые ваши пользователи могут пополнять, используя любую криптовалюту на ваш/их выбор. Для получения полного списка доступных для продажи карт используйте этот метод.

• Параметры:
  

• Примеры:
  - https://trocador.app/api/cards
  

• Результаты:
  - provider: компания, которая доставляет карту;
  - currency_code: в какой валюте номинирована карта (USD, EUR и т. д.);
  - brand: либо Visa, либо Mastercard;
  - amounts: список значений, в которых карта может иметь стоимость;
  - restricted_countries: список стран, где карту нельзя использовать (использование не гарантируется и может привести к блокировке карты);
  - allowed_countries: список стран, где можно использовать карту;
  Если у карты есть список стран с ограниченным доступом, то в остальных странах эту карту, как правило, принимают. То же самое относится и к списку разрешенных стран. Если у карты есть список разрешенных стран, то использование её за его пределами может привести к сбоям в работе карты или её блокировке.

Создайте заказ на покупку предоплаченной карты. Мы поделимся 50% нашего дохода с партнером, который продает карту. Позже, чтобы получить статус вашей покупки, вам нужно будет использовать стандартный метод 'trade' из этой системы API. Детали карты, такие как ссылка для активации, будут включены в ответ метода 'trade'.

• Параметры:
  - provider: поставщик карты, которую ваш пользователь хочет купить;
  - currency_code: фиатная валюта карты, которую вы хотите приобрести;
  - ticker_from: тикер криптовалюты, которую вы хотите использовать для оплаты (например, Bitcoin);
  - network_from: сеть криптовалюты, которую вы хотите использовать для оплаты (например, Mainnet);
  - amount: значение в фиатной валюте карты, которую ваш пользователь хочет купить;
  - email: электронная почта, которая получит код активации карты;
  - card_markup: комиссия, которую вы хотите применить сверх карты, в процентах, для себя; доступные значения 1, 2 или 3; если вы установите этот параметр, мы не будем делиться с вами нашей комиссией, вместо этого вы получите полную наценку (необязательный параметр);

• Примеры:
  - https://trocador.app/api/order_prepaidcard/?currency_code=&provider=&ticker_from=&network_from=&amount=&email=

• Результаты:
  - trade_id: ваш торговый идентификатор;
  - date: дата создания;
  - ticker_from: тикер монеты, которая будет использоваться для оплаты;
  - ticker_to: расчетная криптовалюта, обычно USDT;
  - coin_from: название монеты, используемой для оплаты;
  - coin_to: расчетная криптовалюта, обычно Tether;
  - network_from: сеть монет для оплаты заказа;
  - network_to: сеть расчета монет, обычно TRC20 (для USDT);
  - amount_from: количество монет для использования в качестве оплаты;
  - amount_to: количество криптовалюты от расчета поставщику (USDT);
  - provider: выбранный обмен;
  - fixed: true;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес, который получит расчетную криптовалюту для обработки создания карты;
  - address_user_memo: адрес с мемо/дополнительным идентификатором для получения купленных монет;
  - refund_address: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - refund_address_memo: мемо/дополнительный идентификатор адреса, по которому пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - details: полезная информация о погашении карты, такая как ID, стоимость в фиатной валюте, электронная почта и статус, если карта уже отправлена или если она не удалась;
  - payment: true;

Получите все подарочные карты, доступные для продажи. Теперь вы можете получать доход, продавая подарочные карты от различных продавцов по всему миру. Проверьте доступные карты по странам: если вы не укажете страну, будет предоставлен общий список с ID и названием. Если вы укажете параметр страны, то со списком будут переданы все детали карт.

• Параметры:
  

• Примеры:
  - https://trocador.app/api/giftcards?country=

• Результаты:
  - name: компания, которая доставляет карту;
  - category: категория карты;
  - description: описание карты;
  - terms_and_conditions: условия и положения карты;
  - how_to_use: краткое руководство;
  - expiry_and_validity: срок годности;
  - card_image_url: изображение карты;
  - country: страна, в которой предполагается использовать карту;
  - min_amount: минимальная стоимость карты в местной валюте;
  - max_amount: максимальная стоимость карты в местной валюте;
  - denominations: список возможных значений карты в местной валюте;
  - product_id: ID карты (используйте этот ID для создания заказов);
  

Создайте заказ на покупку подарочной карты. Мы поделимся 50% нашего дохода с партнером, который продает карту. Позже, чтобы получить статус вашей покупки, вам нужно будет использовать стандартный метод 'trade' из этой системы API. Детали карты, такие как ссылка для активации, будут включены в ответ метода 'trade'.

• Параметры:
  - product_id: ID карты, которую ваш пользователь хочет купить;
  - ticker_from: тикер криптовалюты, которую вы хотите использовать для оплаты (например, Bitcoin);
  - network_from: сеть криптовалюты, которую вы хотите использовать для оплаты (например, Mainnet);
  - amount: значение в фиатной валюте карты, которую ваш пользователь хочет купить;
  - email: электронная почта, которая получит код активации карты;
  - card_markup: комиссия, которую вы хотите применить сверх карты, в процентах, для себя; доступные значения 1, 2 или 3; если вы установите этот параметр, мы не будем делиться с вами нашей комиссией, вместо этого вы получите полную наценку (необязательный параметр);

• Примеры:
  - https://trocador.app/api/order_giftcard/?product_id=&ticker_from=&network_from=&amount=&email=

• Результаты:
  - trade_id: ваш торговый идентификатор;
  - date: дата создания;
  - ticker_from: тикер монеты, которая будет использоваться для оплаты;
  - ticker_to: расчётная криптовалюта;
  - coin_from: название монеты, используемой для оплаты;
  - coin_to: расчётная криптовалюта;
  - network_from: сеть монет для оплаты заказа;
  - network_to: сеть расчётов монет;
  - amount_from: количество монет для использования в качестве оплаты;
  - amount_to: сумма криптовалюты от расчетов до поставщика;
  - provider: выбранный обмен;
  - fixed: true;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес, который получит расчетную криптовалюту для обработки создания карты;
  - address_user_memo: адрес с мемо/дополнительным идентификатором для получения купленных монет;
  - refund_address: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - refund_address_memo: мемо/дополнительный идентификатор адреса, по которому пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - details: полезная информация о погашении карты, такая как ID, стоимость в фиатной валюте, электронная почта и статус, если карта уже отправлена или если она не удалась;
  - payment: true;

Этот метод создает две мостовые транзакции с Monero в качестве посредника. Он возвращает адрес сервиса полученный от поставщика, куда пользователь должен отправить свои монеты, чтобы получить запрошенную сумму. Мост Monero состоит из двух транзакций от разных сервисов, при этом один сервис отправляет Monero другой. Адрес возврата от первого сервиса - это адрес возврата пользователя, в то время как второй обмен не имеет адреса возврата, но этот второй адрес возврата может быть переопределен параметром партнера.

• Параметры:
  - ticker_from: тикер монеты, которую вы хотите продать, например, btc (обязательно);
  - network_from: выбор сети, в которой вы хотите продать монеты, например, Основная сеть (обязательно);
  - ticker_to: тикер монеты, которую вы хотите купить, например, xmr (обязательно);
  - network_to: выбор сети, в которой вы хотите купить монеты, например, Основная сеть (обязательно);
  - amount_from or amount_to: количество монет, которое вы хотите продать или получить (amount_from обязательно для стандартных обменов, а amount_to обязательно для платежей);
  - address: адрес, на который пользователь хочет получить свои монеты (обязательно);
  - address_memo: мемо/дополнительный идентификатор адреса, на который пользователь хочет получать свои монеты (если получаемая монета использует мемо/дополнительный идентификатор - используйте '0' для отказа от мемо);
  - refund: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы (необязательно);
  - refund_memo: мемо/дополнительный идентификатор адреса, на который пользователь хочет получить обратно свои монеты в случае возникновения проблем (если применяется возврат и отправленная монета использует мемо/дополнительный идентификатор - используйте '0' для отказа от мемо);
  

• Примеры:
  - https://trocador.app/api/new_bridge/?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=&address=&refund=

• Результаты:
  Первый обмен:
  - trade_id: ваш торговый идентификатор;
  - date: дата создания;
  - ticker_from: тикер монеты, которая будет продана;
  - ticker_to: xmr;
  - coin_from: наименование монеты, которую нужно продать;
  - coin_to: Monero;
  - network_from: сеть для монет, которые будут проданы;
  - network_to: Mainnet;
  - amount_from: количество монет, которые будут проданы;
  - amount_to: количество Monero для покупки;
  - provider: выбранный обмен;
  - fixed: True, если фиксированная ставка, False, если плавающая ставка;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес для получения купленных монет;
  - address_user_memo: '';
  - refund_address: адрес, на который пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - refund_address_memo: мемо/дополнительный идентификатор адреса, по которому пользователь хочет получить обратно свои монеты в случае возникновения проблемы;
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - payment: True или False, в зависимости от того, стандартный ли это обмен или платеж;
  
  Второй обмен:
  - trade_id: ваш торговый идентификатор;
  - date: дата создания;
  - ticker_from: xmr;
  - ticker_to: тикер монеты, которую нужно купить;
  - coin_from: Monero;
  - coin_to: наименование монеты, которую нужно купить;
  - network_from: Mainnet;
  - network_to: сеть для монет, которые нужно купить;
  - amount_from: количество Monero для продажи;
  - amount_to: количество монет, которые нужно купить;
  - provider: выбранный обмен;
  - fixed: True, если фиксированная ставка, False, если плавающая ставка;
  - status: статус сделки;
  - address_provider: адрес сервиса;
  - address_provider_memo: адрес сервиса с мемо/дополнительным идентификатором;
  - address_user: адрес для получения купленных монет;
  - address_user_memo: адрес с мемо/дополнительным идентификатором для получения купленных монет;
  - refund_address: Адрес возврата XMR от Trocador или адрес возврата XMR партнера;
  - refund_address_memo: '';
  - password: пароль, используемый вместе с id_provider для просмотра информации о транзакции на веб-сайте сервиса, используется только определенными поставщиками;
  - id_provider: торговый идентификатор стороны поставщика;
  - payment: True или False, в зависимости от того, стандартный ли это обмен или платеж;

Список всех интегрированных обменных сервисов и их характеристик.

• Примеры:
  - https://trocador.app/api/exchanges/

Это все возможные статусы обмена, которые вы сможете найти при использовании API системы Trocador.

• - new: у вас есть котировка, но вы еще не создали обмен;
  - waiting: вы создали обмен, но депозит еще не был обнаружен;
  - confirming: депозит обнаружен, но еще не подтвержден;
  - sending: депозит подтвержден и поставщик отправляет монеты;
  - paid partially: пользователь внес сумму меньше требуемой. Используется только для AnonPay, карт и AML-проверок;
  - finished: уже есть хэш платежа для пользователя;
  - failed: возможно, что с обменом что-то случилось, обратитесь в службу поддержки;
  - expired: время оплаты истекло;
  - halted: произошла какая-то проблема с обменом, пожалуйста, обратитесь в службу поддержки;
  - refunded: обменный сервис утверждает, что вернул деньги пользователю;