Tron commands

Call a command as POST /v1/tron/{command}. Coverage: TRC20 transfers of USDT, USDD, USDDOLD and jUSDT, and TRX transfers of 1 TRX or more, from 2018 to max_block. Other tokens and failed transactions are not covered. Every Tron amount has 6 decimals: USDD, USDDOLD and jUSDT amounts below 0.000001 are cut off. jUSDT is JustLend’s USDT deposit token, worth about 0.01 USDT, so its amounts are not dollars.

Address forms: T... (34 characters), 0x + 40 hex, 40 hex, or a numeric id from resolve.

Commands

Command	Input	targets	Weight
info	none	–	light
resolve	1–1,000 addresses or ids	–	light
neighbors	1 address	up to 200	light
topk	1 address	up to 200	heavy
trace	1 address	–	heavy
reach	1–50 seeds (one shared search)	up to 50 (one search each)	heavy
annotate	1–1,000 edge ids	–	light

Heavy commands may wait briefly for a free slot. info, resolve and annotate take no options. trace and reach always load labels.

neighbors

Transfers of one address, oldest first.

Option	Range	When omitted
dir	in / out	out
offset	0 – 18446744073709551615	0
limit	1 – 1,000	50
last	1 – 1,000 (not with offset or limit)	–
token	usdt / trx / usdd / usddold / jusdt / all	all
no-labels	switch	labels on

• last N returns the latest N transfers, the cheap “recent activity” view. With token, it walks back until N matching rows are found; on a very busy address a rarely used token can hit deadline.
• total is the address’s transfer count over every token. token filters after the page is cut, so a page can be shorter than limit.
• Rows carry block and tx_index (see Find the transaction hash).

topk

Main counterparties of one address for one token: sum, count, first and last time per counterparty.

Option	Range	When omitted
dir	in / out	out
token	usdt / trx / usdd / usddold / jusdt	usdt
k	1 – 2,000	20
time-start, time-end	0 – 4294967295 (Unix seconds)	whole history
min-amount	0.000001 – 1e15 whole units	none
max-scan	1 – 2,000,000	2,000,000 (server)
no-labels	switch	labels on

• Rows are sorted by sum (descending), then by counterparty, so the same query returns the same rows.
• There is no total count of counterparties. If rows holds exactly k rows, assume more exist: raise k or set min-amount.
• scanned_edges is the address’s whole history in that direction, not just the window. Empty rows under a window means no transfer of that token in it.

trace

Follows funds forward from a source. See Tracing funds.

Option	Range	When omitted
method	rolling / haircut / fifo / poison	rolling
token	usdt / trx / usdd / usddold / jusdt	usdt
hops	1 – 6	3
amount	0.000001 – 1e15 whole units	the source’s outflow from start-block on
start-block	0 – 4294967295	0
min-taint	1e-12 – 1e15	traced amount × 1e-6
stop-labels	1–20 names	cex,exchange,mixer,privacy
hub-degree	1 – 50,000	50,000
max-nodes	1 – 10,000	10,000
max-edges	1 – 20,000	20,000 (server)
max-scan	1 – 2,000,000	2,000,000

A wide trace reaches max-edges early. Narrow it with fewer hops, a higher min-taint or a later start-block.

reach

Searches outward from one or more seeds for addresses with given labels.

Option	Range	When omitted
dir	in / out	in
token	usdt / trx / usdd / usddold / jusdt	usdt
hops	1 – 4	4 (server)
min-edge	0.000001 – 1e15 whole units	100,000
target-labels	1–20 names (required)	–
stop-labels	1–20 names	cex,exchange,mixer,privacy
hub-degree	1 – 80,000	80,000
max-nodes	1 – 50,000	50,000 (server)
max-frontier	1 – 2,000	2,000 (server)
max-contacts	1 – 500	500

• A contact says the money met: a labelled target sits next to via, hop hops from a seed, along path_addrs. amount_f64 is the whole flow between via and the target, not the seed’s share.
• The answer’s targets field counts the labels matching target-labels. 0 means the names matched nothing, and an empty result says nothing about the seed.
• min-edge defaults high (100,000 whole units). Lower it for small cases.
• A seed busier than hub-degree is not expanded.

annotate

Takes up to 1,000 edge ids from a trace and returns block, tx_index, from, to and the amount of each.