{"openapi":"3.1.0","info":{"title":"TronGrid (BYOK) API","version":"0.1.0","description":"TronGrid (BYOK) lets an AI assistant read your own TronGrid data through the TronGrid API with a key you supply (TronGrid API key). Read-only: 12 tools (get_account, list_account_transactions, list_account_trc20_transfers, get_account_trc20_balances, list_account_internal_transactions, get_trc20_token_info, list_trc20_token_holders, list_contract_events, get_transaction_events,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-trongrid.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-trongrid/docs"},"termsOfService":"https://connectorbay.com/byok-trongrid/terms"},"servers":[{"url":"https://byok-trongrid.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-trongrid/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_account":{"post":{"operationId":"get_account","summary":"Get a TRON account: TRX balance in sun (1 TRX = 1,000,000 sun), name, creation time, TRC-10 and TRC-20 balances, votes a","description":"Get a TRON account: TRX balance in sun (1 TRX = 1,000,000 sun), name, creation time, TRC-10 and TRC-20 balances, votes and witness flag. Use for \"What is the TRX balance of this TRON address\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON account address in Base58 form (starts with T) or hex.","maxLength":200,"title":"Address","type":"string"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["address"],"title":"get_accountArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_account_transactions":{"post":{"operationId":"list_account_transactions","summary":"List TRX and TRC-10 transactions of an address with time, block, result, fee and energy use; filter by direction and tim","description":"List TRX and TRC-10 transactions of an address with time, block, result, fee and energy use; filter by direction and time. Use for \"What were the latest transactions of this TRON address\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON account address in Base58 form (starts with T) or hex.","maxLength":200,"title":"Address","type":"string"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"enum":["block_timestamp,desc","block_timestamp,asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order by block time: block_timestamp,desc (default, newest first) or block_timestamp,asc.","title":"Order By"},"min_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or after this block time, in milliseconds since the Unix epoch.","title":"Min Timestamp"},"max_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or before this block time, in milliseconds since the Unix epoch.","title":"Max Timestamp"},"only_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for transactions received by the address only.","title":"Only To"},"only_from":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for transactions sent by the address only.","title":"Only From"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["address"],"title":"list_account_transactionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_account_trc20_transfers":{"post":{"operationId":"list_account_trc20_transfers","summary":"List TRC-20 and TRC-721 token transfers of an address with token symbol, parties, value and time; filter by token contra","description":"List TRC-20 and TRC-721 token transfers of an address with token symbol, parties, value and time; filter by token contract. Use for \"Which token transfers did this TRON address receive recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON account address in Base58 form (starts with T) or hex.","maxLength":200,"title":"Address","type":"string"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"enum":["block_timestamp,desc","block_timestamp,asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order by block time: block_timestamp,desc (default, newest first) or block_timestamp,asc.","title":"Order By"},"min_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or after this block time, in milliseconds since the Unix epoch.","title":"Min Timestamp"},"max_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or before this block time, in milliseconds since the Unix epoch.","title":"Max Timestamp"},"contract_address":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers of this token contract (Base58 or hex).","title":"Contract Address"},"only_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for transfers received by the address only.","title":"Only To"},"only_from":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for transfers sent by the address only.","title":"Only From"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["address"],"title":"list_account_trc20_transfersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_account_trc20_balances":{"post":{"operationId":"get_account_trc20_balances","summary":"List all TRC-20 token balances of an address in one call; each entry maps a token contract address to its raw balance st","description":"List all TRC-20 token balances of an address in one call; each entry maps a token contract address to its raw balance string. Use for \"Which TRC-20 tokens does this TRON address hold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON account address in Base58 form (starts with T) or hex.","maxLength":200,"title":"Address","type":"string"},"contract_address":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Only the balance of this TRC-20 contract (Base58).","title":"Contract Address"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"}},"required":["address"],"title":"get_account_trc20_balancesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_account_internal_transactions":{"post":{"operationId":"list_account_internal_transactions","summary":"List internal transactions (contract-triggered TRX movements) involving an address. Use for \"What internal transactions ","description":"List internal transactions (contract-triggered TRX movements) involving an address. Use for \"What internal transactions touched this TRON address\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON account address in Base58 form (starts with T) or hex.","maxLength":200,"title":"Address","type":"string"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"enum":["block_timestamp,desc","block_timestamp,asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order by block time: block_timestamp,desc (default, newest first) or block_timestamp,asc.","title":"Order By"},"min_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or after this block time, in milliseconds since the Unix epoch.","title":"Min Timestamp"},"max_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or before this block time, in milliseconds since the Unix epoch.","title":"Max Timestamp"},"only_to":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for incoming only.","title":"Only To"},"only_from":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for outgoing only.","title":"Only From"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["address"],"title":"list_account_internal_transactionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_trc20_token_info":{"post":{"operationId":"get_trc20_token_info","summary":"Get name, symbol, decimals, type and total supply for up to 20 token contracts (comma-separated). Use for \"What are the ","description":"Get name, symbol, decimals, type and total supply for up to 20 token contracts (comma-separated). Use for \"What are the symbol and supply of the TRC-20 token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contract_list":{"description":"One contract address, or up to 20 separated by commas (Base58).","maxLength":900,"title":"Contract List","type":"string"}},"required":["contract_list"],"title":"get_trc20_token_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_trc20_token_holders":{"post":{"operationId":"list_trc20_token_holders","summary":"List holders of a TRC-20 token contract; each entry maps a holder address to its balance, largest first by default. Use ","description":"List holders of a TRC-20 token contract; each entry maps a holder address to its balance, largest first by default. Use for \"Who are the largest holders of this TRC-20 token\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contract_address":{"description":"Token contract address (Base58 or hex).","maxLength":200,"title":"Contract Address","type":"string"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"enum":["balance,desc","balance,asc"],"type":"string"},{"type":"null"}],"default":null,"description":"balance,desc (default) or balance,asc.","title":"Order By"}},"required":["contract_address"],"title":"list_trc20_token_holdersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_contract_events":{"post":{"operationId":"list_contract_events","summary":"List events emitted by a smart contract, such as Transfer, optionally by event name, block or time range. Use for \"Show ","description":"List events emitted by a smart contract, such as Transfer, optionally by event name, block or time range. Use for \"Show recent Transfer events of this TRON contract\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contract_address":{"description":"Contract address (Base58 or hex).","maxLength":200,"title":"Contract Address","type":"string"},"event_name":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Only events with this name, for example Transfer.","title":"Event Name"},"block_number":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only events in this block number.","title":"Block Number"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"enum":["block_timestamp,desc","block_timestamp,asc"],"type":"string"},{"type":"null"}],"default":null,"description":"Sort order by block time: block_timestamp,desc (default, newest first) or block_timestamp,asc.","title":"Order By"},"min_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or after this block time, in milliseconds since the Unix epoch.","title":"Min Timestamp"},"max_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only items at or before this block time, in milliseconds since the Unix epoch.","title":"Max Timestamp"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["contract_address"],"title":"list_contract_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_transaction_events":{"post":{"operationId":"get_transaction_events","summary":"List the contract events emitted by one TRON transaction. Use for \"What events did transaction aee87b7bb3e375c7e5e96f8b1","description":"List the contract events emitted by one TRON transaction. Use for \"What events did transaction aee87b7bb3e375c7e5e96f8b1a770c1fac60d483 emit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"transaction_id":{"description":"Transaction hash (64 hex characters).","maxLength":200,"title":"Transaction Id","type":"string"},"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"required":["transaction_id"],"title":"get_transaction_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_latest_block_events":{"post":{"operationId":"get_latest_block_events","summary":"List the contract events of the latest TRON block. Use for \"What contract events happened in the latest TRON block\".","description":"List the contract events of the latest TRON block. Use for \"What contract events happened in the latest TRON block\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"only_confirmed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True to return only confirmed (solidified) results.","title":"Only Confirmed"}},"title":"get_latest_block_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_block_statistics":{"post":{"operationId":"get_block_statistics","summary":"Get statistics of one TRON block: transfer counts, failed and internal transaction counts, and bandwidth and energy use.","description":"Get statistics of one TRON block: transfer counts, failed and internal transaction counts, and bandwidth and energy use. Use for \"How many transfers and failures were in block 61840405\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"block_number":{"description":"Block number.","minimum":0,"title":"Block Number","type":"integer"},"get_tx_detail":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":true,"description":"True to include detailed transaction statistics (txStat).","title":"Get Tx Detail"}},"required":["block_number"],"title":"get_block_statisticsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_trc10_assets":{"post":{"operationId":"list_trc10_assets","summary":"List TRC-10 tokens on TRON with id, name, abbreviation, precision, total supply, owner and start and end time. Use for \"","description":"List TRC-10 tokens on TRON with id, name, abbreviation, precision, total supply, owner and start and end time. Use for \"Which TRC-10 tokens exist on TRON\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"Maximum results per page (1 to 200).","title":"Limit"},"fingerprint":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass meta.fingerprint from the previous answer to get the next page.","title":"Fingerprint"},"order_by":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Sort: total_supply, start_time, end_time or id with ,asc or ,desc, for example total_supply,desc.","title":"Order By"}},"title":"list_trc10_assetsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}