Documentação do API

Este documento detalha como usar nosso sistema de API e fornece exemplos para todas as requests. Todos os métodos podem ser usados tanto pelo link trocador.app na clearnet quanto pelo link onion. All methods are GET, and you just need to include your API Key code on the header to get responses from the server. To include the API key, use: headers = {'API-Key': 'Example-API-Key'}; Siga esses passos para começar a usá-lo:


  • Faça o download da lista de todas as moedas usando o método COINS. Você só precisa fazer isso uma vez. Você precisará usar tanto o símbolo quanto a rede de cada moeda para fazer as requests, já que há moedas com o mesmo símbolo que tem redes diferentes (ex. Matic ERC20 e Polygon). Salve esses dados das moedas em seu banco de dados.
  • Gere novas cotações mandando os parâmetros desejados com o método GET NEW_RATE. Para gerar as cotações você precisa fornecer os símbolos e redes de cada moeda da troca assim como a quantia.
  • Use o rate ID fornecido com as cotações para criar uma nova transação utilizando o método NEW_TRADE. Você deve informar a exchange e tipo de cotação escolhida (fixa ou variável). Caso deseje criar uma transação de pagamento com taxa fixa, mande também essa variável na request.
  • Passe as informações recebidas para o usuário, para que ele possa transferir as moedas para o endereço indicado da exchange.
  • Endpoints:
    • Normal: https://trocador.app/api/
    • Onion: http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/
    • I2P: trocador.i2p/api/
  • Este método retorna todas as moedas listadas em nosso serviço, com seus nomes, símbolos, redes e quantias mínimas e máximas. Você pode usar esse método para preencher seu banco de dados e deve usar os símbolos e redes informados para criar suas cotações e transações.


    • Parâmetros:

    • Exemplos:
      - https://trocador.app/api/coins
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/coins
      - trocador.i2p/api/coins

    • Resultados:
      - name: nome da moeda;
      - ticker: símbolo da moeda;
      - network: rede da moeda;
      - memo: se a rede da moeda usa memo/ExtraID. True ou False;
      - image: ícone da moeda;
      - minimum: quantia mínima que pode ser negociada;
      - maximum: quantia máxima que pode ser negociada;
  • Este método retorna todos os dados das moedas com o símbolo ou nome fornecidos. Caso várias moedas tenham o mesmo símbolo, o método retorna uma lista com todas elas. Ao menos um símbolo ou nome é obrigatório.


    • Parâmetros:
      - ticker: o símbolo da moeda desejada, por exemplo btc (Opcional);
      - name: o nome da moeda desejada, por exemplo Bitcoin (Opcional);

    • Exemplos:
      - https://trocador.app/api/coin?ticker=btc
      - https://trocador.app/api/coin?name=Bitcoin
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/coin?ticker=btc
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/coin?name=Bitcoin
      - trocador.i2p/api/coin?ticker=btc
      - trocador.i2p/api/coin?name=Bitcoin

    • Resultados:
      - name: nome da moeda;
      - ticker: símbolo da moeda;
      - network: rede da moeda;
      - memo: se a rede da moeda usa memo/ExtraID. True ou False;
      - image: ícone da moeda;
      - minimum: quantia mínima que pode ser negociada;
      - maximum: quantia máxima que pode ser negociada;
  • Esse método retorna todas as transações não deletadas do parceiro em nosso banco de dados ou uma transação específica com o ID fornecido na request. Isso pode ser utilizado para fornecer o status atualizado da transação ao usuário. Isso só é possível caso os dados da transação ainda estejam em nosso banco de dados. Depois de 14 dias, ou quando o usuário solicitar, os dados da transação são deletados para proteger sua privacidade.


    • Parâmetros:
      - id: o ID da transação (Opcional);

    • Exemplos:
      - https://trocador.app/api/trade
      - https://trocador.app/api/trade?id=ID
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/trade
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/trade?id=ID
      - trocador.i2p/api/trade
      - trocador.i2p/api/trade?id=ID

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data e horário de criação;
      - ticker_from: símbolo da moeda a ser vendida;
      - ticker_to: símbolo da moeda a ser comprada;
      - coin_from: nome da moeda a ser vendida;
      - coin_to: nome da moeda a ser comprada;
      - network_from: rede da moeda a ser vendida;
      - network_to: rede da moeda a ser comprada;
      - amount_from: quantia da moeda a ser vendida;
      - amount_to: quantia da moeda a ser comprada;
      - provider: exchange escolhida;
      - fixed: True para taxa Fixa ou False para taxa variável;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço para receber as moedas compradas;
      - address_user_memo: memo/ExtraID do endereço para receber as moedas compradas;
      - refund_address: endereço no qual receber o reembolso caso seja necessário;
      - refund_address_memo: memo/ExtraID do endereço no qual receber o reembolso caso seja necessário;
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - quotes:
       support: dados do suporte da exchange;
       expiresAt: horário e data de quando a transação expira;
      - details:
       hashout: hash da transação de pagamento. Apenas disponível quando a transação foi completada;
      - payment: True or False, dependendo se é uma troca padrão ou um pagamento;
  • Este método checa se o endereço fornecido pode ser utilizado com uma certa moeda. Se você não quiser checar todo endereço não há necessidade, já que no sistema sempre faz essa checagem antes de criar uma transação. Esta função retorna True ou False dependendo se o endereço fornecido é válido para a moeda e rede informadas.


    • Parâmetros:
      - ticker: o símbolo da moeda a ser testada, por exemplo btc (Obrigatório);
      - network: a rede da moeda a ser testada, por exemplo Mainnet (Obrigatório);
      - address: o endereço da moeda a ser testado (Obrigatório);

    • Exemplos:
      - https://trocador.app/api/validateaddress?ticker=&network=&address=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/validateaddress?ticker=&network=&address=
      - trocador.i2p/api/validateaddress?ticker=&network=&address=

    • Resultados:
      - result: True se o endereço for válido ou False se não for;
  • Esse método gera uma lista de cotações de todas as exchanges e as organiza de melhor cotação para pior. Junto com as cotações vai a nota KYC de cada exchange, de A (sem KYC) até D (pode segurar indefinidamente as moedas do usuário até verificação). Este método retorna um ID único que deve ser utilizado para criar uma transação nova.


    • Parâmetros:
      - ticker_from: o símbolo da moeda a ser vendida, por exemplo btc (Obrigatório);
      - network_from: a rede da moeda a ser vendida, por exemplo Mainnet (Obrigatório);
      - ticker_to: o símbolo da moeda a ser comprada, por exemplo xmr (Obrigatório);
      - network_to: a rede da moeda a ser comprada, por exemplo Mainnet (Obrigatório);
      - amount_from or amount_to: a quantia da moeda a ser vendida ou recebida (amount_from é obrigatório para trocas padrão, enquanto amount_to é mandatório para pagamentos);
      - payment: True ou Falso, dependendo se você quer criar uma transação padrão ou uma de pagamento (Opcional);
      - min_kycrating: caso deseje apenas cotações em exchanges com uma nota mínima de KYC de A, B, C ou D, por favor forneça esse parâmetro (Opcional);
      - min_logpolicy: caso deseje apenas cotações em exchanges com uma nota mínima de política de logs de A, B ou C, por favor forneça esse parâmetro (Opcional);
      - markup: possibilitamos que parceiros definam sua própria comissão, em percentual (Opcional); deve ser 0, 1, 1.85 ou 3 (em %); caso o parceiro forneça markup=0 ou não forneça este parâmetro, Trocador compartilhará metade de sua comissão com o parceiro; atente-se que ao utilizar markup > 0 o usuário final verá cotações piores quando comparadas àquelas mostradas no site Trocador;
      - best_only: caso deseje receber apenas a melhor cotação para os parâmetros fornecidos, informe True (Opcional);

    • Exemplos:
      - https://trocador.app/api/new_rate?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/new_rate?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=
      - trocador.i2p/api/new_rate?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data e horário de criação;
      - ticker_from: símbolo da moeda a ser vendida;
      - ticker_to: símbolo da moeda a ser comprada;
      - coin_from: nome da moeda a ser vendida;
      - coin_to: nome da moeda a ser comprada;
      - network_from: rede da moeda a ser vendida;
      - network_to: rede da moeda a ser comprada;
      - amount_from: quantia da moeda a ser vendida;
      - amount_to: quantia da moeda a ser comprada;
      - provider: exchange com a melhor cotação;
      - fixed: tipo de cotação da melhor cotação, True para Fixa e False para Variável;
      - status: status da transação;
      - quotes: lista de todas as cotações geradas, com suas notas KYC e diferença percentual em relação à melhor cotação;
      - payment: True or False, dependendo se é uma troca padrão ou um pagamento;
  • Este método cria uma transação com o ID fornecido, com a exchange e tipo de cotação escolhido. Ele retorna o endereço da exchange para o qual o usuário deve transferir as moedas a serem vendidas.


    • Parâmetros:
      - id: o ID da cotação gerada anteriormente (Opcional); caso o parceiro não forneça o ID de uma transação previamente criada pelo método new_rate, a transação será gerada automaticamente com a melhor cotação encontrada utilizando os parâmetros informados, como se tivesse sido utilizado o parâmetro best_only do método new_rate;
      - ticker_from: o símbolo da moeda a ser vendida, por exemplo btc (Obrigatório);
      - network_from: a rede da moeda a ser vendida, por exemplo Mainnet (Obrigatório);
      - ticker_to: o símbolo da moeda a ser comprada, por exemplo xmr (Obrigatório);
      - network_to: a rede da moeda a ser comprada, por exemplo Mainnet (Obrigatório);
      - amount_from or amount_to: a quantia da moeda a ser vendida ou recebida (amount_from é obrigatório para trocas padrão, enquanto amount_to é mandatório para pagamentos);
      - address: o endereço no qual o usuário deseja receber suas moedas (Obrigatório);
      - address_memo: o memo/ExtraID do endereço no qual o usuário deseja receber suas moedas (Obrigatório caso a moeda recebida utilize memo/ExtraID - Use '0' se não tiver memo);
      - refund: o endereço no qual o usuário deseja receber seu reembolso caso aconteça algum problema (Opcional);
      - refund_memo: o memo/ExtraID do endereço no qual o usuário deseja receber seu reembolso caso aconteça algum problema (Obrigatório caso reembolso seja usado e a moeda enviada utilize memo/ExtraID - Use '0' se não tiver memo);
      - provider: a exchange escolhida (Obrigatório);
      - fixed: True para cotação FIxa ou False para cotação Variável (Obrigatório);
      - payment: True ou Falso, dependendo se você quer criar uma transação padrão ou uma de pagamento (Opcional);
      - min_kycrating: caso deseje apenas cotações em exchanges com uma nota mínima de KYC de A, B, C ou D, por favor forneça esse parâmetro (Opcional);
      - min_logpolicy: caso deseje apenas cotações em exchanges com uma nota mínima de política de logs de A, B ou C, por favor forneça esse parâmetro (Opcional);
      - webhook: se fornecer uma URL neste parâmetro, cada vez que o status da transação for alterado você receberá uma request POST nessa URL com os dados da transação; isso evita que seu sistema tenha que ficar checando frequentemente o status da transação (Opcional);
      - markup: possibilitamos que parceiros definam sua própria comissão, em percentual (Opcional); deve ser 0, 1, 2 ou 3; caso o parceiro forneça markup=0 ou não forneça este parâmetro, Trocador compartilhará metade de sua comissão com o parceiro; atente-se que ao utilizar markup > 0 o usuário final verá cotações piores quando comparadas àquelas mostradas no site Trocador;

    • Exemplos:
      - 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=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=&refund=
      - trocador.i2p/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=
      - trocador.i2p/api/new_trade?id=&ticker_from=&ticker_to=&network_to=&network_from=&amount_from=&address=&provider=&fixed=&refund=

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: símbolo da moeda a ser vendida;
      - ticker_to: símbolo da moeda a ser comprada;
      - coin_from: nome da moeda a ser vendida;
      - coin_to: nome da moeda a ser comprada;
      - network_from: rede da moeda a ser vendida;
      - network_to: rede da moeda a ser comprada;
      - amount_from: quantia da moeda a ser vendida;
      - amount_to: quantia da moeda a ser comprada;
      - provider: exchange escolhida;
      - fixed: True para taxa Fixa ou False para taxa variável;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço para receber as moedas compradas;
      - address_user_memo: memo/ExtraID do endereço para receber as moedas compradas;
      - refund_address: o endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - refund_address_memo: memo/ExtraID do endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - payment: True or False, dependendo se é uma troca padrão ou um pagamento;
  • Get all prepaid cards available for sale. You can now generate income by selling USD and EUR Visa and Mastercard prepaid cards, which your users can load using any crypto of your/their choice. To get the complete list of available cards for sale, use this method.


    • Parâmetros:

    • Exemplos:
      - https://trocador.app/api/cards
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/cards
      - trocador.i2p/api/cards

    • Resultados:
      - provider: a empresa que fornece o cartão;
      - currency_code: which currency that the card is denominated (USD, EUR, etc);
      - brand: Visa ou Mastercard;
      - amounts: lista de valores possíveis para o cartão;
      - restricted_countries: lista de países nos quais o cartão não pode ser usado (aceitação não é garantida e uso pode levar ao cartão ser bloqueado);
      - allowed_countries: lista de países onde o cartão pode ser usado;
      If the card has a list of restricted countries, then other countries out of this list usually accept the card. The opposite goes to the list of allowed countries. If a card has a list of allowed countries, then using it outside of these may lead to the card malfunctioning or being blocked.
  • Cria uma ordem de compra de cartão pré-pago. We'll share 50% of our income with the partner that sells a card. Later, to get the status of your purchase, you need to use the regular method 'trade' from this API system. Card details, such as activation link, will go along the response of the method 'trade'.


    • Parâmetros:
      - provider: o provedor do cartão que seu usuário deseja comprar;
      - currency_code: a moeda fiat do cartão que seu usuário deseja comprar;
      - ticker_from: o símbolo da moeda a ser usada para o pagamento, por exemplo xmr;
      - network_from: a rede da moeda a ser usada para o pagamento, por exemplo Mainnet;
      - amount: o valor em fiat do cartão que seu usuário deseja comprar;
      - email: Um email para receber o link de ativação do cartão;
      - card_markup: the commission that you want applied above the card, in percentage, for yourself; available values of 1, 2 or 3; if you set this parameter then we won't share our commission with you, instead, you'll receive the full markup (optional parameter);

    • Exemplos:
      - https://trocador.app/api/order_prepaidcard/?currency_code=&provider=&ticker_from=&network_from=&amount=&email=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/order_prepaidcard/?currency_code=&provider=&ticker_from=&network_from=&amount=&email=
      - trocador.i2p/api/order_prepaidcard/?currency_code=&provider=&ticker_from=&network_from=&amount=&email=

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: ticker da moeda a ser usada para o pagamento;
      - ticker_to: ticker da moeda a ser recebida pelo provedor, geralmente USDT;
      - coin_from: nome da moeda a ser usada como pagamento;
      - coin_to: nome da moeda a ser recebida pelo provedor, geralmente Tether;
      - network_from: rede da moeda a ser usada como pagamento;
      - network_to: rede da moeda a ser recebida pelo provedor, geralmente TRC20;
      - amount_from: quantia da moeda a ser usada como pagamento;
      - amount_to: quantia da moeda a ser recebida pelo provedor;
      - provider: exchange escolhida;
      - fixed: true;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço do provedor que receberá o pagamento já convertido;
      - address_user_memo: memo/ExtraID do endereço para receber as moedas compradas;
      - refund_address: o endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - refund_address_memo: memo/ExtraID do endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - details: dados úteis do cartão, como ID, valor em fiat, email e status de envio do email;
      - payment: true;
  • Get all giftcards available for sale. You can now generate income by selling gift cards from various sellers around the globe. Check available cards by country: if you do not provide the country, a general list with ID and name will be provided. If you provide the country parameter, then all details from the cards will go with the reply.


    • Parâmetros:

    • Exemplos:
      - https://trocador.app/api/giftcards?country=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/giftcards?country=
      - trocador.i2p/api/giftcards?country=

    • Resultados:
      - name: a empresa que fornece o cartão;
      - category: category of the card;
      - description: description of the card;
      - terms_and_conditions: terms and conditions of the card;
      - how_to_use: a quick guide;
      - expiry_and_validity: expiration date;
      - card_image_url: image of the card;
      - country: country where the card is supposed to be spent;
      - min_amount: minimum value of the card in local currency;
      - max_amount: maximum value of the card in local currency;
      - denominations: a list of possible values of the card in local currency;
      - product_id: the ID of the card (use this ID to generate orders);
  • Create an order to buy a giftcard. We'll share 50% of our income with the partner that sells a card. Later, to get the status of your purchase, you need to use the regular method 'trade' from this API system. Card details, such as activation link, will go along the response of the method 'trade'.


    • Parâmetros:
      - product_id: the ID of the card your user want to buy;
      - ticker_from: o símbolo da moeda a ser usada para o pagamento, por exemplo xmr;
      - network_from: a rede da moeda a ser usada para o pagamento, por exemplo Mainnet;
      - amount: o valor em fiat do cartão que seu usuário deseja comprar;
      - email: Um email para receber o link de ativação do cartão;
      - card_markup: the commission that you want applied above the card, in percentage, for yourself; available values of 1, 2 or 3; if you set this parameter then we won't share our commission with you, instead, you'll receive the full markup (optional parameter);

    • Exemplos:
      - https://trocador.app/api/order_giftcard/?product_id=&ticker_from=&network_from=&amount=&email=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/order_giftcard/?product_id=&ticker_from=&network_from=&amount=&email=
      - trocador.i2p/api/order_giftcard/?product_id=&ticker_from=&network_from=&amount=&email=

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: ticker da moeda a ser usada para o pagamento;
      - ticker_to: the settlement crypto;
      - coin_from: nome da moeda a ser usada como pagamento;
      - coin_to: the settlement crypto;
      - network_from: rede da moeda a ser usada como pagamento;
      - network_to: network of coin settlement;
      - amount_from: quantia da moeda a ser usada como pagamento;
      - amount_to: amount of crypto from the settlement to the provider;
      - provider: exchange escolhida;
      - fixed: true;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço do provedor que receberá o pagamento já convertido;
      - address_user_memo: memo/ExtraID do endereço para receber as moedas compradas;
      - refund_address: o endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - refund_address_memo: memo/ExtraID do endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - details: dados úteis do cartão, como ID, valor em fiat, email e status de envio do email;
      - payment: true;
  • Create an order to buy credits; If your user already has an access_code (for AML checks), your existing code will receive a top up; if your user does not hold an access_code, then a new one will be generated for you;


    • Parâmetros:
      - ticker_from: the coin you wish to use for payment of the order to purchase credits;
      - network_from: the network of the coin you wish to use for payment of the order to purchase credits;
      - amount: number of credits you want to purchase;
      - access_code: the access_code that you want to top up (optional);

    • Exemplos:
      - https://trocador.app/api/order_amlchecks/?ticker_from=&network_from=&amount=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/order_amlchecks/?ticker_from=&network_from=&amount=
      - trocador.i2p/api/order_amlchecks/?ticker_from=&network_from=&amount=

    • Resultados:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: ticker da moeda a ser usada para o pagamento;
      - coin_from: nome da moeda a ser usada como pagamento;
      - network_from: rede da moeda a ser usada como pagamento;
      - amount_from: quantia da moeda a ser usada como pagamento;
      - fixed: true;
      - payment: true;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - details: useful data regarding the number_of_checks, access_code and fiat price of the purchase;
  • Create an assessment to check a transaction or an address; in case you want to check a transaction instead of an address, or in case the transaction still has no block confirmations, you should provide the hash involved (optional); if you want to check a transaction, then the result will show what is the AML risk of the token that was transfered on that hash; checking an address, on the opposite, will result on the combined AML risk of all tokens that are located on the address; if you check an address, you can provide parameters ticker and network of any of the current tokens that are being held on that address, since all of them will have the same network;


    • Parâmetros:
      - access_code: access_code previously purchased;
      - address: address that you want to check for AML;
      - ticker: ticker of the coin that is the native token of the network you want to perform the check;
      - network: network of the coin that you want to check for AML;
      - tx_hash: in case you want to check a transaction instead of an address, or in case the transaction still has no block confirmations, you should provide the hash involved (optional); if you want to check a transaction, then the result will show what is the AML risk of the token that was transfered on that hash; checking an address, on the opposite, will result on the combined AML risk of all tokens that are located on the address; if you check an address, you can provide parameters ticker and network of any of the current tokens that are being held on that address, since all of them will have the same network;;

    • Exemplos:
      - https://trocador.app/api/perform_amlcheck/?access_code=&address=&network=&tx_hash=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/perform_amlcheck/?access_code=&address=&network=&tx_hash=
      - trocador.i2p/api/perform_amlcheck/?access_code=&address=&network=&tx_hash=

    • Resultados:
      - id: ID of the AML check;
      - date: date of check;
      - datetime: date and time of the check;
      - network: network name that was checked;
      - network_label: ticker of the network that was checked;
      - type: type of check, either address or transaction;
      - tx_hash_short: abreviated transaction hash;
      - tx_hash: transaction hash;
      - address_short: abreviated address checked;
      - address: address checked;
      - risk: total risk involved;
      - high_risk_signals: composition of high risk;
      - medium_risk_signals: composition of medium risk;
      - low_risk_signals: composition of low risk;
  • Get all possible networks to perform checks


    • Parâmetros:

    • Exemplos:
      - https://trocador.app/api/amlcheck_networks
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/amlcheck_networks
      - trocador.i2p/api/amlcheck_networks

    • Resultados:
      - name: name of the network;
      - ticker_trocador: ticker of the network (use these values when calling the AML methods);
  • Get all history of assessments for a certain access_code


    • Parâmetros:
      - access_code: your access_code (Mandatory);

    • Exemplos:
      - https://trocador.app/api/assessments/?access_code=
      - http://trocadorfyhlu27aefre5u7zri66gudtzdyelymftvr4yjwcxhfaqsid.onion/api/assessments/?access_code=
      - trocador.i2p/api/assessments/?access_code=

    • Resultados:
      - All data regarding the AML checks you performed with the given access_code;
  • Este método cria duas transações de Ponte, com Monero como intermediário. Ele retorna o endereço da exchange para o qual o usuário deve transferir as moedas a serem vendidas. A Monero Bridge é composta por duas transações de diferentes exchanges, com uma exchange enviando Monero para a outra. O endereço de reembolso da primeira troca é o endereço de reembolso do usuário, enquanto a segunda troca não tem endereço de reembolso, mas esse segundo endereço de reembolso pode ser substituído por um parâmetro do parceiro.


    • Parâmetros:
      - ticker_from: o símbolo da moeda a ser vendida, por exemplo btc (Obrigatório);
      - network_from: a rede da moeda a ser vendida, por exemplo Mainnet (Obrigatório);
      - ticker_to: o símbolo da moeda a ser comprada, por exemplo xmr (Obrigatório);
      - network_to: a rede da moeda a ser comprada, por exemplo Mainnet (Obrigatório);
      - amount_from or amount_to: a quantia da moeda a ser vendida ou recebida (amount_from é obrigatório para trocas padrão, enquanto amount_to é mandatório para pagamentos);
      - address: o endereço no qual o usuário deseja receber suas moedas (Obrigatório);
      - address_memo: o memo/ExtraID do endereço no qual o usuário deseja receber suas moedas (Obrigatório caso a moeda recebida utilize memo/ExtraID - Use '0' se não tiver memo);
      - refund: o endereço no qual o usuário deseja receber seu reembolso caso aconteça algum problema (Opcional);
      - refund_memo: o memo/ExtraID do endereço no qual o usuário deseja receber seu reembolso caso aconteça algum problema (Obrigatório caso reembolso seja usado e a moeda enviada utilize memo/ExtraID - Use '0' se não tiver memo);

    • Exemplos:
      - https://trocador.app/api/new_bridge/?ticker_from=&ticker_to=&network_from=&network_to=&amount_from=&address=&refund=

    • Resultados:
      Primeira transação:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: símbolo da moeda a ser vendida;
      - ticker_to: xmr;
      - coin_from: nome da moeda a ser vendida;
      - coin_to: Monero;
      - network_from: rede da moeda a ser vendida;
      - network_to: Mainnet;
      - amount_from: quantia da moeda a ser vendida;
      - amount_to: quantia de Monero a ser comprado;
      - provider: exchange escolhida;
      - fixed: True para taxa Fixa ou False para taxa variável;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço para receber as moedas compradas;
      - address_user_memo: '';
      - refund_address: o endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - refund_address_memo: memo/ExtraID do endereço no qual o usuário quer receber de volta suas moedas caso aconteça algum problema;
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - payment: True or False, dependendo se é uma troca padrão ou um pagamento;

      Segunda transação:
      - trade_id: o ID da transação conosco;
      - date: data de criação;
      - ticker_from: xmr;
      - ticker_to: símbolo da moeda a ser comprada;
      - coin_from: Monero;
      - coin_to: nome da moeda a ser comprada;
      - network_from: Mainnet;
      - network_to: rede da moeda a ser comprada;
      - amount_from: quantia de Monero a ser vendido;
      - amount_to: quantia da moeda a ser comprada;
      - provider: exchange escolhida;
      - fixed: True para taxa Fixa ou False para taxa variável;
      - status: status da transação;
      - address_provider: endereço da exchange;
      - address_provider_memo: memo/ExtraID do endereço da exchange;
      - address_user: endereço para receber as moedas compradas;
      - address_user_memo: memo/ExtraID do endereço para receber as moedas compradas;
      - refund_address: Endereço de reembolso Monero do parceiro ou do Trocador;
      - refund_address_memo: '';
      - password: senha utilizada em conjunto com o id_provider para ver a transação no site da exchange. Usada apenas por algumas exchanges;
      - id_provider: o ID da transação no provedor;
      - payment: True or False, dependendo se é uma troca padrão ou um pagamento;
  • List of all integrated crypto exchanges and their characteristics.


    • Exemplos:
      - https://trocador.app/api/exchanges/
  • Estes são todos os possíveis status que uma transação pode ter.


    • - new: você tem cotações, mas ainda não criou a transação;
      - waiting: você criou a transação, mas nenhum depósito foi detectado;
      - confirming: o depósito foi detectado, mas ainda aguarda confirmações de rede;
      - sending: o depósito foi confirmado e a corretora está enviando as moedas;
      - finished: já existe um hash da transação de pagamento;
      - failed: algo aconteceu com a transação, por favor contate nosso suporte;
      - expired: o período para pagamento expirou;
      - halted: algo aconteceu com a transação, por favor contate nosso suporte;
      - refunded: a corretora reembolsou o usuário;