{"openapi":"3.1.0","info":{"title":"TRONSCAN (BYOK) API","version":"0.1.0","description":"TRONSCAN (BYOK) lets an AI assistant read your own TRONSCAN data through the TRONSCAN API with a key you supply (TRONSCAN API key). Read-only: 12 tools (list_blocks, list_tokens, get_token_price, get_trc20_token, list_trc20_holders, get_trc20_total_supply, get_account, list_account_tokens, list_transactions, get_transaction, list_trc20_transfers, get_transaction_statistics). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tronscan.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tronscan/docs"},"termsOfService":"https://connectorbay.com/byok-tronscan/terms"},"servers":[{"url":"https://byok-tronscan.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tronscan/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/list_blocks":{"post":{"operationId":"list_blocks","summary":"List recent TRON blocks, newest first, or fetch one block by number. Optionally filter by producing super representative","description":"List recent TRON blocks, newest first, or fetch one block by number. Optionally filter by producing super representative or time range. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What are the latest TRON blocks\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items to return, 1 to 50 (default 10).","title":"Limit"},"number":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Block number; when given, only that block is returned.","title":"Number"},"producer":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Super representative address to filter by.","title":"Producer"},"sort":{"anyOf":[{"enum":["-number","number"],"type":"string"},{"type":"null"}],"default":"-number","description":"Sort by block number: -number (default, newest first) or number.","title":"Sort"},"start_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only blocks after this time in milliseconds since the Unix epoch.","title":"Start Timestamp"},"end_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only blocks before this time in milliseconds since the Unix epoch.","title":"End Timestamp"}},"title":"list_blocksArguments","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_tokens":{"post":{"operationId":"list_tokens","summary":"List tokens (TRC10, TRC20, TRC721, TRC1155) with market data, sorted by market cap, volume, price change or holder count","description":"List tokens (TRC10, TRC20, TRC721, TRC1155) with market data, sorted by market cap, volume, price change or holder count. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"Which TRON tokens have the largest market cap\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many tokens to return, 1 to 50 (default 20).","title":"Limit"},"filter":{"anyOf":[{"enum":["all","top","trc10","trc20","trc721","trc1155"],"type":"string"},{"type":"null"}],"default":"all","description":"Token type filter.","title":"Filter"},"sort":{"anyOf":[{"enum":["marketcap","priceInTrx","gain","volume24hInTrx","holderCount"],"type":"string"},{"type":"null"}],"default":"marketcap","description":"Sort field.","title":"Sort"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"Sort direction.","title":"Order"}},"title":"list_tokensArguments","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_token_price":{"post":{"operationId":"get_token_price","summary":"Get the current price of a token by its abbreviation (default trx). The documentation does not list response fields, so ","description":"Get the current price of a token by its abbreviation (default trx). The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What is the current TRX price on TRONSCAN\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"token":{"anyOf":[{"maxLength":30,"type":"string"},{"type":"null"}],"default":"trx","description":"Token abbreviation such as trx or usdt.","title":"Token"}},"title":"get_token_priceArguments","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":{"post":{"operationId":"get_trc20_token","summary":"Get details of a TRC20, TRC721 or TRC1155 token contract such as name, symbol, decimals, supply and holders. The documen","description":"Get details of a TRC20, TRC721 or TRC1155 token contract such as name, symbol, decimals, supply and holders. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What are the details of the TRC20 contract TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contract":{"description":"Token contract address starting with T.","maxLength":60,"title":"Contract","type":"string"},"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items to return, 1 to 50 (default 10).","title":"Limit"}},"required":["contract"],"title":"get_trc20_tokenArguments","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_holders":{"post":{"operationId":"list_trc20_holders","summary":"List holders of a TRC20, TRC721 or TRC1155 token, optionally for one holder address. The documentation does not list res","description":"List holders of a TRC20, TRC721 or TRC1155 token, optionally for one holder address. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"Who are the biggest holders of the TRC20 token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contract_address":{"description":"TRC20 token contract address starting with T.","maxLength":60,"title":"Contract Address","type":"string"},"holder_address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only this holder's balance.","title":"Holder Address"},"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items to return, 1 to 50 (default 10).","title":"Limit"}},"required":["contract_address"],"title":"list_trc20_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/get_trc20_total_supply":{"post":{"operationId":"get_trc20_total_supply","summary":"Get the total supply of a TRC20 token contract. The documentation does not list response fields, so the answer is return","description":"Get the total supply of a TRC20 token contract. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What is the total supply of the TRC20 token TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRC20 contract address starting with T.","maxLength":60,"title":"Address","type":"string"}},"required":["address"],"title":"get_trc20_total_supplyArguments","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":{"post":{"operationId":"get_account","summary":"Get one TRON account's balance, resources and activity summary by address. The documentation does not list response fiel","description":"Get one TRON account's balance, resources and activity summary by address. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What is the balance and activity of TRON address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON address starting with T (base58, 34 characters).","maxLength":60,"title":"Address","type":"string"}},"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_tokens":{"post":{"operationId":"list_account_tokens","summary":"List the tokens an address holds with balance above zero, with prices and amounts. The documentation does not list respo","description":"List the tokens an address holds with balance above zero, with prices and amounts. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"Which tokens does TRON address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t hold\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"address":{"description":"TRON address starting with T (base58, 34 characters).","maxLength":60,"title":"Address","type":"string"},"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first token (0 by default).","title":"Start"},"limit":{"anyOf":[{"maximum":200,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many tokens to return, 1 to 200 (default 20).","title":"Limit"},"show":{"anyOf":[{"maximum":4,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Token kinds: 0 default, 1 TRC20, 2 TRC721, 3 all, 4 TRC1155.","title":"Show"},"hidden":{"anyOf":[{"maximum":1,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"0 hides tokens with tiny balances (default), 1 shows them.","title":"Hidden"}},"required":["address"],"title":"list_account_tokensArguments","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_transactions":{"post":{"operationId":"list_transactions","summary":"List TRON transactions, newest first, filtered by account, direction, block or time range. The documentation does not li","description":"List TRON transactions, newest first, filtered by account, direction, block or time range. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What are the latest transactions of TRON address TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items to return, 1 to 50 (default 10).","title":"Limit"},"address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Account address to filter by (sender or receiver, see direction).","title":"Address"},"direction":{"anyOf":[{"enum":["in","out","all"],"type":"string"},{"type":"null"}],"default":null,"description":"With address: in, out or all.","title":"Direction"},"block":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only transactions of this block number.","title":"Block"},"start_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only after this time in milliseconds since the Unix epoch.","title":"Start Timestamp"},"end_timestamp":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only before this time in milliseconds since the Unix epoch.","title":"End Timestamp"}},"title":"list_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_transaction":{"post":{"operationId":"get_transaction","summary":"Get the details of one TRON transaction by its hash. The documentation does not list response fields, so the answer is r","description":"Get the details of one TRON transaction by its hash. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"Show TRON transaction 3e3b4cb8cf8fd4ec4cd3e41e1b8a0b9e2d4d5a0e5e1d8a2c2fb0e6f4e3d1a2b\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"hash":{"description":"Transaction hash, 64 hex characters.","maxLength":70,"title":"Hash","type":"string"}},"required":["hash"],"title":"get_transactionArguments","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_transfers":{"post":{"operationId":"list_trc20_transfers","summary":"List TRC20 and TRC721 token transfers, optionally for one contract or one related address. The documentation does not li","description":"List TRC20 and TRC721 token transfers, optionally for one contract or one related address. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What are the latest USDT transfers on TRON\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"start":{"anyOf":[{"maximum":10000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Offset of the first item (0 by default); start plus limit must not exceed 10000.","title":"Start"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many items to return, 1 to 50 (default 10).","title":"Limit"},"contract_address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers of this token contract.","title":"Contract Address"},"related_address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers sent or received by this address.","title":"Related Address"},"from_address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers sent by this address.","title":"From Address"},"to_address":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers received by this address.","title":"To Address"}},"title":"list_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_transaction_statistics":{"post":{"operationId":"get_transaction_statistics","summary":"Get network-wide TRON transaction statistics. The documentation does not list response fields, so the answer is returned","description":"Get network-wide TRON transaction statistics. The documentation does not list response fields, so the answer is returned as the API sends it (shortened if very large). Use for \"What are the overall TRON transaction statistics\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_transaction_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}}}}