DeFiStream - Dashboard

Native TRX Transfers

Track native TRX transfers on the Tron blockchain.

Endpoint: GET /v1/tron/native/events/transfer

Range Parameters (one pair required):

Parameter	Type	Description
`block_start`	integer	Start block number (inclusive). Must be used with `block_end`.
`block_end`	integer	End block number (inclusive). Must be used with `block_start`.
`since`	string	Start time (ISO 8601 or Unix timestamp). Must be used with `until`.
`until`	string	End time (ISO 8601 or Unix timestamp). Must be used with `since`.

You must provide either block_start/block_end or since/until, but not both.

Filter Parameters:

Parameter	Type	Required	Description
`min_amount`	number	No	Minimum amount (in TRX)
`max_amount`	number	No	Maximum amount (0 = no limit)
`sender`	string	No	Filter by sender address
`receiver`	string	No	Filter by receiver address
`involving`	string	No	Filter by address involved as either sender OR receiver
`involving_label`	string	No	Filter where any address matches a label substring
`involving_category`	string	No	Filter where any address matches a category

Example: Large TRX transfers

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/tron/native/events/transfer?since=2025-12-01T00:00:00Z&until=2025-12-02T00:00:00Z&min_amount=100000" 
  -o trx_large.csv

Sample Results:

block_number	token	sender	receiver	amount	time
68000200	TRX	TQn9Y2…R7Kx	TVj8Rr…N3Wq	500000.0	2025-12-01T00:10:15Z
68000350	TRX	TLa7Bc…P2Mj	TFh4Xn…K8Dp	250000.0	2025-12-01T00:17:42Z

Aggregate Queries

Bucket native TRX transfers by time or block number for totals per window.

Endpoint: GET /v1/tron/native/events/transfer/aggregate

Accepts all filters from the raw endpoint (sender, receiver, involving, min_amount, max_amount) plus:

Parameter	Type	Default	Description
`group_by`	string	`time`	`time` or `block_number`
`period`	string	`1h` / `1000`	Time: `1m`, `5m`, `30m`, `1h`, `1d`, `1w`. Block: integer block count.

Example: Hourly TRX volume

curl -H "X-API-Key: $API_KEY" 
  "https://api.defistream.dev/v1/tron/native/events/transfer/aggregate?block_start=80000000&block_end=80001000&group_by=time&period=1h"

Response:

{
  "status": "success",
  "events": [
    {"time": "2026-02-09T19:00:00Z", "token": "TRX", "agg_amount": 16082893.46, "count": 107906},
    {"time": "2026-02-09T20:00:00Z", "token": "TRX", "agg_amount": 3726808.60, "count": 22841}
  ],
  "count": 2
}

Each row contains {time | block_number, token, agg_amount, count}. agg_amount is the SUM of transfer amounts (in TRX) and count is the number of events in the bucket.

Schema discovery: GET /v1/tron/native/aggregate_schema.

Range limits and cost: Same as the raw endpoint. Aggregate quota cost: block_range × 0.5 (min 100).

Quota & Limits

Tron endpoints use a time-based quota model similar to exchange data endpoints.

Check response headers X-RateLimit-Remaining and X-Request-Cost to monitor usage.