Docs
⌘ K

Swap Events

GET/v1/tvm/swaps

Returns DEX swap transactions from Tron protocols with token amounts and prices.

Query Parameters

ParameterDescriptionValue
network
string

The Graph Network ID for TVM networks https://thegraph.com/networks

  • Accepted values: tron
Required
tron
transaction_id
string

Filter by transaction hash
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^[0-9a-fA-F]{64}$
  • Format: tvm-tx-hash
factory
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
pool
string

Filter by pool address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
transaction_from
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
user
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
sender
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
recipient
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
input_contract
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
output_contract
string

Filter by address
Single value or array of values* (separate multiple values with ,)
*Plan restricted.

  • Accepted pattern: ^T[1-9A-HJ-NP-Za-km-z]{33}$
  • Format: tvm-address
protocol
string

Protocol name

  • Accepted values: uniswap_v1, uniswap_v2, uniswap_v3, uniswap_v4, sunpump
uniswap_v2
start_time
string

UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

    end_time
    string

    UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

      start_block
      integer

      Filter by block number

      • Minimum value: 0
      • Maximum value: 9007199254740991
      end_block
      integer

      Filter by block number

      • Minimum value: 0
      • Maximum value: 9007199254740991
      limit
      integer

      Number of items* returned in a single request.
      *Plan restricted.

      • Default value: 10
      • Minimum value: 1
      • Maximum value: 1000
      page
      integer

      Page number to fetch.
      Empty data array signifies end of results.

      • Default value: 1
      • Minimum value: 1
      • Maximum value: 767465558638

      Potential Responses

      StatusDescription
      200

      Successful Response

      400

      Client side error

      401

      Authentication failed

      403

      Forbidden

      404

      Not found

      500

      Server side error