API documentation
https://tronapi.net/api/.<METHOD>?key=<YOUR_API_KEY>¶m1=value1¶m2=value2&...
Parameter | Description | Example |
---|---|---|
METHOD |
One of the methods: balance - Get balance give - Create new address track - Create new track request send - Create request of sending coins status - Get status of request | balance |
YOUR_API_KEY | Your API access key from settings | 5c2dc9d3fa-df73e0d10d-2715eb503f-685b1965d8 |
address | Destination address | TCDi83CFLJZZ9kC4He95YRYbpzaRAZ8ptu |
token* | Token symbols | USDT |
amount | Amount of coins | 0.123456 |
statusURL* | (URL-encoded) URL to your IPN handler | https://your-domain/handler.php?a=1&b=2 |
tag* | Tag (label) of operation | Any string: oper12 |
lifetime* | Maximum tracking time in minutes | 30 |
Examples
https://tronapi.net/api/.balance?key=<YOUR_API_KEY>&token=USDT
https://tronapi.net/api/.give?key=<YOUR_API_KEY>&token=USDT&tag=oper12&statusURL=<URL_ENCODED>
https://tronapi.net/api/.track?key=<YOUR_API_KEY>&address=<PAYEE_ADDR>&amount=<AMOUNT>&tag=oper12&lifetime=30&statusURL=<URL_ENCODED>
https://tronapi.net/api/.send?key=<YOUR_API_KEY>&address=<PAYEE_ADDR>&amount=<AMOUNT>&tag=oper12&statusURL=<URL_ENCODED>
https://tronapi.net/api/.status?key=<YOUR_API_KEY>&id=<REQUEST_ID>
IPN handler
Notifications come from IP = 88.99.198.205
Data in JSON format:
{
tronapi.net: version
type: message type = (in-payment / track-track / out-sending)
date: date and time in UNIX format
from: address-sender
to: address-receiver
token: token (empty for TRX tx)
amount: amount
fee: network fee
txid: transaction txid (hash)
confirmations: number of confirmations (0 - in mempool / 1 - first / 10 - final / 100 - manually)
tag: tag
sign: signature
}
PHP Code Example:
...
if (!$_POST)
$_POST = @json_decode(file_get_contents('php://input'), true);
if (!$_POST['tronapi.net'])
return;
$sign = sha1(implode(':', array(
$_POST['type'],
$_POST['date'],
$_POST['from'],
$_POST['to'],
isset($_POST['token']) ? $_POST['token'] : '',
$_POST['amount'],
$_POST['txid'],
$_POST['confirmations'],
$_POST['tag'],
$cfg['apikey'] // API access key
)));
if ($sign !== $_POST['sign'])
die('Sign wrong'); // this answer will be visible in the dashboard
echo('OK');
...
Pricing
We don't take a percentage from a transaction and do not require a monthly fee. You pay only for actually spent resources (cost of 1 credit = 0.01 USD):
- For each address created - 1 credit
- For each track created - 1 credit
- For each transaction tracked - 1 credit
- For each transaction sent to the network - 1 credit
- For each successful IPN - 1 credit
Calculation examples (if statusURL is specified):
- Reception:
Tag creation + payment IPN = 2 credits x 0.01 = 0.02 USD (2 cents) - Sending:
Transaction sending + IPN = 2 credits x 0.01 = 0.02 USD (2 cents)