{"openapi":"3.1.0","info":{"title":"Routescan (BYOK) API","version":"0.1.0","description":"Routescan (BYOK) lets an AI assistant read your own Routescan data through the Routescan API with a key you supply (Routescan API key (free registered plan is enough)). Read-only: 12 tools (get_balance, get_balances_multi, list_transactions, list_internal_transactions, list_token_transfers, get_token_balance, get_token_supply, list_token_holders, get_token_info, get_transaction_receipt_status,...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-routescan.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-routescan/docs"},"termsOfService":"https://connectorbay.com/byok-routescan/terms"},"servers":[{"url":"https://byok-routescan.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-routescan/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_balance":{"post":{"operationId":"get_balance","summary":"Get the native coin balance of one address in wei (AVAX on chain 43114, ETH on chain 1); divide by 10^18 for whole coins","description":"Get the native coin balance of one address in wei (AVAX on chain 43114, ETH on chain 1); divide by 10^18 for whole coins. The answer has status 0 and a message when there is nothing to return. Use for \"What is the AVAX balance of address 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"address":{"description":"Account address, 0x followed by 40 hex characters.","maxLength":42,"title":"Address","type":"string"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"balance","type":"string"},{"type":"null"}],"default":"balance","description":"Fixed by this tool; do not change.","title":"Action"},"tag":{"anyOf":[{"enum":["latest","earliest","pending"],"type":"string"},{"type":"null"}],"default":"latest","description":"Block to read at: latest, earliest or pending.","title":"Tag"}},"required":["chain_id","address"],"title":"get_balanceArguments","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_balances_multi":{"post":{"operationId":"get_balances_multi","summary":"Get the native coin balance of up to 20 addresses in one call (wei). Use for \"What are the balances of these two address","description":"Get the native coin balance of up to 20 addresses in one call (wei). Use for \"What are the balances of these two addresses on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"address":{"description":"Up to 20 addresses separated by commas, each 0x followed by 40 hex characters.","maxLength":900,"title":"Address","type":"string"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"balancemulti","type":"string"},{"type":"null"}],"default":"balancemulti","description":"Fixed by this tool; do not change.","title":"Action"},"tag":{"anyOf":[{"enum":["latest","earliest","pending"],"type":"string"},{"type":"null"}],"default":"latest","description":"Block to read at: latest, earliest or pending.","title":"Tag"}},"required":["chain_id","address"],"title":"get_balances_multiArguments","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 the normal transactions of an address (sent or received) with hash, block, time, parties, value, gas and error flag","description":"List the normal transactions of an address (sent or received) with hash, block, time, parties, value, gas and error flag. Values are in wei. The answer has status 0 and a message when there is nothing to return. Use for \"What are the latest transactions of address 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"address":{"description":"Account address, 0x followed by 40 hex characters.","maxLength":42,"title":"Address","type":"string"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"txlist","type":"string"},{"type":"null"}],"default":"txlist","description":"Fixed by this tool; do not change.","title":"Action"},"startblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"First block number to search from.","title":"Startblock"},"endblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Last block number to search to.","title":"Endblock"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"offset":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Offset"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"asc for oldest first, desc for newest first.","title":"Sort"}},"required":["chain_id","address"],"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/list_internal_transactions":{"post":{"operationId":"list_internal_transactions","summary":"List the internal transactions (value moved by contracts) that involve an address. The answer has status 0 and a message","description":"List the internal transactions (value moved by contracts) that involve an address. The answer has status 0 and a message when there is nothing to return. Use for \"Which internal transactions involve address 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"address":{"description":"Account address, 0x followed by 40 hex characters.","maxLength":42,"title":"Address","type":"string"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"txlistinternal","type":"string"},{"type":"null"}],"default":"txlistinternal","description":"Fixed by this tool; do not change.","title":"Action"},"startblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"First block number to search from.","title":"Startblock"},"endblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Last block number to search to.","title":"Endblock"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"offset":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Offset"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"asc for oldest first, desc for newest first.","title":"Sort"}},"required":["chain_id","address"],"title":"list_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/list_token_transfers":{"post":{"operationId":"list_token_transfers","summary":"List ERC-20 token transfers of an address, optionally for one token contract, with token name, symbol and decimals. The ","description":"List ERC-20 token transfers of an address, optionally for one token contract, with token name, symbol and decimals. The answer has status 0 and a message when there is nothing to return. Use for \"Which ERC-20 transfers did address 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 make on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"tokentx","type":"string"},{"type":"null"}],"default":"tokentx","description":"Fixed by this tool; do not change.","title":"Action"},"address":{"anyOf":[{"maxLength":42,"type":"string"},{"type":"null"}],"default":null,"description":"Account address, 0x followed by 40 hex characters.","title":"Address"},"contractaddress":{"anyOf":[{"maxLength":42,"type":"string"},{"type":"null"}],"default":null,"description":"Only transfers of this token contract.","title":"Contractaddress"},"startblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"First block number to search from.","title":"Startblock"},"endblock":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Last block number to search to.","title":"Endblock"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"offset":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Offset"},"sort":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"desc","description":"asc for oldest first, desc for newest first.","title":"Sort"}},"required":["chain_id"],"title":"list_token_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_token_balance":{"post":{"operationId":"get_token_balance","summary":"Get the ERC-20 token balance of an address in the token's smallest unit; divide by 10^decimals. The answer has status 0 ","description":"Get the ERC-20 token balance of an address in the token's smallest unit; divide by 10^decimals. The answer has status 0 and a message when there is nothing to return. Use for \"How much USDC does address 0x9f8f72aa9304c8b593d555f12ef6589cc3a579a2 hold on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"contractaddress":{"description":"Token contract address, 0x followed by 40 hex characters.","maxLength":42,"title":"Contractaddress","type":"string"},"address":{"description":"Account address, 0x followed by 40 hex characters.","maxLength":42,"title":"Address","type":"string"},"module":{"anyOf":[{"const":"account","type":"string"},{"type":"null"}],"default":"account","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"tokenbalance","type":"string"},{"type":"null"}],"default":"tokenbalance","description":"Fixed by this tool; do not change.","title":"Action"},"tag":{"anyOf":[{"enum":["latest","earliest","pending"],"type":"string"},{"type":"null"}],"default":"latest","description":"Block to read at: latest, earliest or pending.","title":"Tag"}},"required":["chain_id","contractaddress","address"],"title":"get_token_balanceArguments","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_supply":{"post":{"operationId":"get_token_supply","summary":"Get the total supply of an ERC-20 token in its smallest unit. The answer has status 0 and a message when there is nothin","description":"Get the total supply of an ERC-20 token in its smallest unit. The answer has status 0 and a message when there is nothing to return. Use for \"What is the total supply of USDC on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"contractaddress":{"description":"Token contract address, 0x followed by 40 hex characters.","maxLength":42,"title":"Contractaddress","type":"string"},"module":{"anyOf":[{"const":"stats","type":"string"},{"type":"null"}],"default":"stats","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"tokensupply","type":"string"},{"type":"null"}],"default":"tokensupply","description":"Fixed by this tool; do not change.","title":"Action"}},"required":["chain_id","contractaddress"],"title":"get_token_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/list_token_holders":{"post":{"operationId":"list_token_holders","summary":"List the current holders of a token with their quantities, largest first as the API orders them. The answer has status 0","description":"List the current holders of a token with their quantities, largest first as the API orders them. The answer has status 0 and a message when there is nothing to return. Use for \"Who are the holders of USDC on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"contractaddress":{"description":"Token contract address, 0x followed by 40 hex characters.","maxLength":42,"title":"Contractaddress","type":"string"},"module":{"anyOf":[{"const":"token","type":"string"},{"type":"null"}],"default":"token","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"tokenholderlist","type":"string"},{"type":"null"}],"default":"tokenholderlist","description":"Fixed by this tool; do not change.","title":"Action"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"},"offset":{"anyOf":[{"maximum":1000,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"Records per page, 1 to 1000.","title":"Offset"}},"required":["chain_id","contractaddress"],"title":"list_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/get_token_info":{"post":{"operationId":"get_token_info","summary":"Get a token's type, name, symbol, total supply, website and social links. The answer has status 0 and a message when the","description":"Get a token's type, name, symbol, total supply, website and social links. The answer has status 0 and a message when there is nothing to return. Use for \"What is the token at contract 0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e on Avalanche\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"contractaddress":{"description":"Token contract address, 0x followed by 40 hex characters.","maxLength":42,"title":"Contractaddress","type":"string"},"module":{"anyOf":[{"const":"token","type":"string"},{"type":"null"}],"default":"token","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"tokeninfo","type":"string"},{"type":"null"}],"default":"tokeninfo","description":"Fixed by this tool; do not change.","title":"Action"}},"required":["chain_id","contractaddress"],"title":"get_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/get_transaction_receipt_status":{"post":{"operationId":"get_transaction_receipt_status","summary":"Check whether a transaction succeeded: result.status is 1 for success and 0 for failure. Use for \"Did transaction 0x513c","description":"Check whether a transaction succeeded: result.status is 1 for success and 0 for failure. Use for \"Did transaction 0x513c1ba0bebf66436b5fed86ab668452b7805593c05073eb2d51d3a52f480a76 succeed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"txhash":{"description":"Transaction hash, 0x followed by 64 hex characters.","maxLength":66,"title":"Txhash","type":"string"},"module":{"anyOf":[{"const":"transaction","type":"string"},{"type":"null"}],"default":"transaction","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"gettxreceiptstatus","type":"string"},{"type":"null"}],"default":"gettxreceiptstatus","description":"Fixed by this tool; do not change.","title":"Action"}},"required":["chain_id","txhash"],"title":"get_transaction_receipt_statusArguments","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_gas_oracle":{"post":{"operationId":"get_gas_oracle","summary":"Get the current safe, proposed and fast gas prices and base fee suggestion of the chain (in gwei). Use for \"What is the ","description":"Get the current safe, proposed and fast gas prices and base fee suggestion of the chain (in gwei). Use for \"What is the gas price on Avalanche right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"module":{"anyOf":[{"const":"gastracker","type":"string"},{"type":"null"}],"default":"gastracker","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"gasoracle","type":"string"},{"type":"null"}],"default":"gasoracle","description":"Fixed by this tool; do not change.","title":"Action"}},"required":["chain_id"],"title":"get_gas_oracleArguments","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_number_by_time":{"post":{"operationId":"get_block_number_by_time","summary":"Find the block number mined closest before or after a Unix timestamp (seconds). The answer has status 0 and a message wh","description":"Find the block number mined closest before or after a Unix timestamp (seconds). The answer has status 0 and a message when there is nothing to return. Use for \"Which Avalanche block was mined around Unix time 1700000000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"chain_id":{"description":"Numeric chain id of the Routescan-indexed network: 1 Ethereum, 43114 Avalanche C-Chain, 5000 Mantle, 81457 Blast, 43111 Hemi.","minimum":1,"title":"Chain Id","type":"integer"},"timestamp":{"description":"Unix timestamp in seconds.","minimum":0,"title":"Timestamp","type":"integer"},"module":{"anyOf":[{"const":"block","type":"string"},{"type":"null"}],"default":"block","description":"Fixed by this tool; do not change.","title":"Module"},"action":{"anyOf":[{"const":"getblocknobytime","type":"string"},{"type":"null"}],"default":"getblocknobytime","description":"Fixed by this tool; do not change.","title":"Action"},"closest":{"anyOf":[{"enum":["before","after"],"type":"string"},{"type":"null"}],"default":"before","description":"Take the block before or after the timestamp.","title":"Closest"}},"required":["chain_id","timestamp"],"title":"get_block_number_by_timeArguments","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}}}}