This document details how to use our API system and provides examples for all requests. All methods could be used both via the clearnet link trocador.app or via the onion address. 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'}; Follow these steps to start using it:
This method returns all coins listed in our database, with their names, tickers, networks and minimum and maximum amounts. You can use this method to populate your database, and you must use these tickers and networks when creating transactions.
This method returns all data from the coins that have the specified name or ticker. In case multiple coins have the same ticker, the method returns a list with all of them. At least one ticker or name is mandatory.
This method returns all non-deleted trades from the partner on our database, or an specific transaction that has the ID provided on the request. This can be used to show the user the updated transaction status. This is only possible if the transaction data is still stored in our database. After 14 days, or on user request, transaction data is deleted to protect the user's privacy.
This method checks if a given address can be used with a certain coin. If you don't want to check every address there's no need to, since the system always performs this check before creating a transaction. This function returns True or False depending on if the provided address fits the given coin and network.
This method generates a list of rates from all providers and organizes them from best to worst rate. Along with the rates goes the KYC Score of each exchange, from A (no KYC) to D (may hold user's funds indefinitely until verification). This method returns a unique ID that you must use if you want to create a transaction.
This method creates a transaction with the provided ID, on the selected exchange and rate type. It returns the address from the provider exchange, where the user must send his coins in order to receive the requested amount.
Get all prepaid and giftcards 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.
Create an order to buy a prepaid card. 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'.
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;
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;
Get all possible networks to perform checks
Get all history of assessments for a certain access_code
This method creates two Bridge transactions with Monero as the intermediary. It returns the address from the provider exchange, where the user must send his coins in order to receive the requested amount. The Monero Bridge is composed by two transactions from different exchanges, with one exchange sending Monero to the other. The refund address from the first exchange is the user refund address, while the second swap has no refund address, but this second refund address can be overriden by a parameter from the partner.
List of all integrated crypto exchanges and their characteristics.
These are all possible swap statuses you will find when calling Trocador API system.