TronGrid Transactions API

The Transactions API from TronGrid — 2 operation(s) for transactions.

GitHub OpenAPI

Operations 2

GET /v1/transactions/{transactionId}/internal-transactions Get internal transactions by transaction ID #
GET /v1/transactions/{transactionID}/events Get events by transaction id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/trongrid:trongrid-transactions-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

trongrid-transactions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: trongrid-v1-api Transactions API
  version: 4.8.0
servers:
- url: https://api.shasta.trongrid.io
tags:
- name: Transactions
paths:
  /v1/transactions/{transactionId}/internal-transactions:
    get:
      summary: Get internal transactions by transaction ID
      description: ''
      operationId: get-internal-transactions-by-transactionid
      parameters:
      - name: transactionId
        in: path
        description: The unique ID for the parent transaction.
        schema:
          type: string
        required: true
      - name: only_confirmed
        in: query
        description: Set to `true` to return only confirmed transactions; set to `false` (or omit) to return both confirmed and unconfirmed. Cannot be used simultaneously with `only_unconfirmed`.
        schema:
          type: boolean
      - name: only_unconfirmed
        in: query
        description: Set to `true` to return only unconfirmed transactions; set to `false` (or omit) to return both. Cannot be used simultaneously with `only_confirmed`.
        schema:
          type: boolean
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        internal_tx_id:
                          type: string
                          description: The unique ID for the internal transaction.
                        data:
                          type: object
                          properties:
                            note:
                              type: string
                              description: The type of instruction, such as `call`, `create`, `suicide`, `freezeBalanceV2ForEnergy`, `freezeBalanceV2ForBandwidth`, or `unfreezeBalanceV2ForBandwidth`.
                            rejected:
                              type: boolean
                              description: Whether the internal transaction failed during execution. `true` signifies failure.
                            call_value:
                              type: object
                              description: 'Transfer amount map `{ "_": <amount> }`. Key `_` denotes TRX (amount in sun); other keys are TRC-10 token IDs. Always present.'
                        block_timestamp:
                          type: integer
                          format: int64
                          description: 'The block timestamp. (Unit: millisecond)'
                        to_address:
                          type: string
                          description: The recipient's address.
                        tx_id:
                          type: string
                          description: The transaction hash of the parent transaction that initiated this internal transaction.
                        from_address:
                          type: string
                          description: The sender's address.
                  success:
                    type: boolean
                    description: Whether the request succeeded. `true` on success.
                  meta:
                    $ref: '#/components/schemas/Meta'
              examples:
                Result:
                  value: '{}'
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Transactions
  /v1/transactions/{transactionID}/events:
    get:
      summary: Get events by transaction id
      description: ''
      operationId: get-events-by-transaction-id
      parameters:
      - name: transactionID
        in: path
        description: 'The specific transaction hash to query.

          Example: `aee87b7bb3e375c7e5e96f8b1a770c1fac60d483f56267fd77e663a3e9512a1a`'
        schema:
          type: string
        required: true
      - name: only_unconfirmed
        in: query
        description: Set to `true` to return only unconfirmed events; set to `false` (or omit) to return both. Cannot be used simultaneously with `only_confirmed`.
        schema:
          type: boolean
      - name: only_confirmed
        in: query
        description: Set to `true` to return only confirmed events; set to `false` (or omit) to return both confirmed and unconfirmed. Cannot be used simultaneously with `only_unconfirmed`.
        schema:
          type: boolean
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        block_number:
                          type: integer
                          format: int64
                          description: The block number.
                        block_timestamp:
                          type: integer
                          format: int64
                          description: 'The block timestamp. (Unit: millisecond)'
                        caller_contract_address:
                          type: string
                          description: Same as `data.[0].contract_address` for backward compatibility.
                        contract_address:
                          type: string
                          description: The address of the contract that emitted the event.
                        event_index:
                          type: integer
                          description: The event's index within the transaction's event log.
                        event_name:
                          type: string
                          description: The event name.
                        event:
                          type: string
                          description: The event signature used to parse indexed and non-indexed parameters. (e.g., `Transfer(address,address,uint256)`)
                        transaction_id:
                          type: string
                          description: Transaction hash.
                        result:
                          type: object
                          description: The event's parameters, including both indexed and non-indexed parameters.
                        result_type:
                          type: object
                          description: The type of parameter.
                        _unconfirmed:
                          type: boolean
                          description: Whether the transaction is unconfirmed. `true` means unconfirmed.
                  success:
                    type: boolean
                    description: Whether the request was successful.
                  meta:
                    type: object
                    properties:
                      page_size:
                        type: integer
                        format: int32
                        description: The number of items returned on the current page.
                      at:
                        type: integer
                        format: int64
                        description: 'The response timestamp. (Unit: millisecond).'
              examples:
                Result:
                  value: '{}'
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Transactions
components:
  schemas:
    Meta:
      type: object
      description: TronGrid response envelope — pagination + timing metadata. Present on every successful TronGrid v1 response.
      properties:
        at:
          type: integer
          format: int64
          description: 'Server timestamp when the response was generated. (Unit: millisecond)'
        page_size:
          type: integer
          description: Number of items returned in this page.
        fingerprint:
          type: string
          description: Opaque pagination cursor. Pass back as the `fingerprint` query parameter to fetch the next page.
        links:
          type: object
          description: Pagination links.
          properties:
            next:
              type: string
              description: URL for the next page (empty if this is the last page).
x-readme:
  headers: []
  explorer-enabled: true
  proxy-enabled: true
x-readme-fauxas: true