{"openapi":"3.1.0","info":{"title":"Whale Alert (BYOK) API","version":"0.1.0","description":"Whale Alert (BYOK) lets an AI assistant read your own Whale Alert data through the Whale Alert API with a key you supply (Whale Alert Enterprise API key). Read-only: 7 tools (list_supported_blockchains, get_blockchain_status, get_transaction, list_transactions, get_block, get_block_by_hash, get_height_at_time). The BYOK key travels with each request, is used for that one call only and is never...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-whale-alert.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-whale-alert/docs"},"termsOfService":"https://connectorbay.com/byok-whale-alert/terms"},"servers":[{"url":"https://byok-whale-alert.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-whale-alert/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_supported_blockchains":{"post":{"operationId":"list_supported_blockchains","summary":"List the blockchains covered by Whale Alert and the coin and token symbols tracked on each. Use for \"Which blockchains a","description":"List the blockchains covered by Whale Alert and the coin and token symbols tracked on each. Use for \"Which blockchains and tokens does Whale Alert track\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_supported_blockchainsArguments","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_blockchain_status":{"post":{"operationId":"get_blockchain_status","summary":"Get the oldest and newest available block heights of one blockchain and the lowest height your plan can read. Use for \"H","description":"Get the oldest and newest available block heights of one blockchain and the lowest height your plan can read. Use for \"How far back can I query Bitcoin transactions on my Whale Alert plan\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"}},"required":["blockchain"],"title":"get_blockchain_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_transaction":{"post":{"operationId":"get_transaction","summary":"Get one transaction by hash with fee, time and sub-transactions showing inputs, outputs, amounts, USD unit price and att","description":"Get one transaction by hash with fee, time and sub-transactions showing inputs, outputs, amounts, USD unit price and attributed owners (older than 30 days is not returned on standard access). Use for \"Show the Whale Alert details of this Bitcoin transaction\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"},"hash":{"description":"Transaction hash.","maxLength":130,"title":"Hash","type":"string"}},"required":["blockchain","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_transactions":{"post":{"operationId":"list_transactions","summary":"List transactions of a blockchain from a start block height, filtered by address, symbol, amount range, direction or typ","description":"List transactions of a blockchain from a start block height, filtered by address, symbol, amount range, direction or type; follow the next link in the answer for more. Use for \"Which USDT transfers above 1,000,000 happened on Ethereum since block 20000000\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"},"start_height":{"description":"Block height to start from.","minimum":0,"title":"Start Height","type":"integer"},"end_height":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Block height to stop at.","title":"End Height"},"address":{"anyOf":[{"maxLength":130,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions involving this address.","title":"Address"},"symbol":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions with a sub-transaction in this symbol; required when min_amount or max_amount is used.","title":"Symbol"},"min_amount":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Minimum amount in coin or token units; needs symbol.","title":"Min Amount"},"max_amount":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Maximum amount in coin or token units; needs symbol.","title":"Max Amount"},"mutation":{"anyOf":[{"enum":["received","sent"],"type":"string"},{"type":"null"}],"default":null,"description":"received or sent; needs address.","title":"Mutation"},"transaction_type":{"anyOf":[{"enum":["transfer","mint","burn","freeze","unfreeze","lock","unlock"],"type":"string"},{"type":"null"}],"default":null,"description":"Type of transaction.","title":"Transaction Type"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Maximum transactions to return (1 to 100; the API default is 10).","title":"Limit"},"order":{"anyOf":[{"enum":["asc","desc"],"type":"string"},{"type":"null"}],"default":"asc","description":"asc (default) or desc by height.","title":"Order"}},"required":["blockchain","start_height"],"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_block":{"post":{"operationId":"get_block","summary":"Get the timestamp, hash and transactions of the block at a given height. Use for \"What transactions were in Bitcoin bloc","description":"Get the timestamp, hash and transactions of the block at a given height. Use for \"What transactions were in Bitcoin block 771103\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"},"height":{"description":"Block height.","minimum":0,"title":"Height","type":"integer"}},"required":["blockchain","height"],"title":"get_blockArguments","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_by_hash":{"post":{"operationId":"get_block_by_hash","summary":"Get the timestamp, hash and transactions of the block with a given hash. Use for \"Show the block with this hash on Bitco","description":"Get the timestamp, hash and transactions of the block with a given hash. Use for \"Show the block with this hash on Bitcoin\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"},"hash":{"description":"Block hash.","maxLength":130,"title":"Hash","type":"string"}},"required":["blockchain","hash"],"title":"get_block_by_hashArguments","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_height_at_time":{"post":{"operationId":"get_height_at_time","summary":"Find the block height and block time at or around a Unix timestamp in seconds. Use for \"Which Bitcoin block was current ","description":"Find the block height and block time at or around a Unix timestamp in seconds. Use for \"Which Bitcoin block was current on 2023-01-09\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"blockchain":{"description":"Blockchain name in lowercase as returned by list_supported_blockchains, for example bitcoin, ethereum or tron.","maxLength":40,"title":"Blockchain","type":"string"},"timestamp":{"description":"Unix timestamp in seconds.","minimum":0,"title":"Timestamp","type":"integer"}},"required":["blockchain","timestamp"],"title":"get_height_at_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}}}}