Server definition
- Hash
- sha256:ec4a04d2005190f155207b31eb3d4dc1d52842cba2a7951aedbc204b0f880868
- What it is
- What a remote MCP server returned when asked what it offers: 146 tools
The blob, as servednamed by its sha256
{
"instructions": "Pay-per-call x402 agent, no account and no API key. 136 atomic read routes at $0.001 USDC each — 63 chain-state primitives over public RPC (base, ethereum, arbitrum, bsc, polygon, optimism, avalanche), 69 venue reads (Kraken, Coinbase Exchange, OKX, Bitfinex, Gate, KuCoin, Deribit, Hyperliquid, DeFiLlama, mempool.space and blockchain.info for Bitcoin, alternative.me sentiment, Polymarket, DexScreener, Jupiter and the Blockscout explorers) and 4 /market/x402-* rail-intelligence reads carrying our own measured 30-day demand map of this rail (calls and unique payers per listed host, from the keyless public discovery index) — plus POST /audit for a crypto-bot honesty scan at $0.01. Every route is reachable over MCP under its own tool name and over plain HTTP GET; both answer byte-identically. Each mirrored tool advertises an outputSchema and returns the same object as structuredContent, so a client can decode the reply without parsing a text blob.",
"tools": [
{
"description": "Input one JS/TS source file (string). Returns findings for: testnet-as-USD, silent-zero balance, cooldown key mismatch, fake faucet endpoint, speculative earnings text. Costs $0.01 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"code": {
"description": "one JS/TS file",
"type": "string"
},
"filename": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"name": "audit_bot_code",
"outputSchema": null
},
{
"description": "balanceOf(account, id) for a multi-token contract, formatted with whatever supply unit the contract uses — the read a Zora/Sudoswap-style position tracker needs, which an ERC-20 or ERC-721 lookup cannot answer. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/1155-balance?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&account=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account": {
"description": "holder address [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"account",
"tokenId"
],
"type": "object"
},
"name": "chain_1155_balance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account": {
"type": "string"
},
"balanceRaw": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"supported": {
"type": "boolean"
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "balanceOfBatch over up to 10 (account, id) pairs in a single settled call — the position snapshot of a portfolio, which is otherwise one paid read per line. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/1155-batch?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&accounts=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenIds=1,2.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"accounts": {
"description": "up to 10 holder addresses, positionally matched to tokenIds [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
},
"tokenIds": {
"description": "up to 10 ids (decimal), same order as accounts [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"accounts",
"tokenIds"
],
"type": "object"
},
"name": "chain_1155_batch",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answered": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "supportsInterface for the multi-token ids plus contractURI and a probe of one id — the pre-flight before a client assumes a contract is a 721 and sends the wrong call. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/1155-check?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "id to probe uri() with (default 0) (default 0)",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_1155_check",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"contractURI": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"probedTokenId": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"standards": {
"additionalProperties": {},
"type": "object"
},
"supported": {
"type": "boolean"
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "uri(id) decoded from the ABI string, with the {id} substitution left visible instead of followed — the metadata URL a wallet will fetch, returned as text and never requested by us. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/1155-uri?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"tokenId"
],
"type": "object"
},
"name": "chain_1155_uri",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"raw": {
"type": "string"
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"template": {
"type": "boolean"
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"ts": {
"type": "string"
},
"uri": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "allowance(owner, spender) in raw and decimal form — how much a approval still lets a third party move, which is the number behind most drain headlines. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/allowance?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&spender=0x0000000000000000000000000000000000000000.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"spender": {
"description": "allowance spender address [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owner",
"spender"
],
"type": "object"
},
"name": "chain_allowance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"formatted": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"raw": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"spender": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
},
"unlimitedApproval": {
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Approval events for one token over a short, bounded window, decoded to owner/spender/amount — the ledger of who just gave someone leave to move their USDC. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/approvals-scan?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&blocks=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"description": "window size in blocks (bounded) (default 10)",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_approvals_scan",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"decimals": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"range": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Native coin balance (wei plus a decimal string) at the latest block, with the chain's symbol so the number cannot be misread as USD. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/balance?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_balance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"balance": {
"description": "decimal-formatted native amount",
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"nativeSymbol": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"wei": {
"description": "balance in wei",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Up to 25 addresses in one paid call — the shape a portfolio or risk bot actually needs, cheaper than 25 single lookups. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/balances?chain=base&addresses=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"addresses": {
"description": "comma list of up to 25 addresses [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"addresses"
],
"type": "object"
},
"name": "chain_balances",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"nativeSymbol": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "One block header decoded: height, time, author, gas used vs limit, base fee in gwei and transaction count. Readable numbers, not raw hex. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block?chain=base&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"additionalProperties": {},
"description": "decoded header",
"type": "object"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The same decoded header /chain/block gives, addressed by hash instead of height — which is what a receipt, a log or a reorg report actually hands you. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-by-hash?chain=base&blockHash=0x1c2e3a….",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockHash": {
"description": "block hash, 0x + 64 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"blockHash"
],
"type": "object"
},
"name": "chain_block_by_hash",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"additionalProperties": {},
"type": "object"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"requestedHash": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Binary-searches the header timestamps for the first block at or after a unix time — every 'what was the supply / who held what on that date' question starts here, and no public node offers the lookup. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-by-timestamp?chain=base×tamp=1758000000.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"timestamp": {
"description": "unix seconds to locate a block at [required]",
"type": "string"
}
},
"required": [
"chain",
"timestamp"
],
"type": "object"
},
"name": "chain_block_by_timestamp",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"type": "integer"
},
"blockTimestamp": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"hash": {
"type": "string"
},
"head": {
"type": "integer"
},
"isoTime": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"probes": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"requestedTimestamp": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Latest block number for one chain straight from a public node — the cheapest possible 'is the chain alive and where is it' check. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-number?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block_number",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"description": "latest block height",
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getBlockReceipts in a single paid call: per-transaction gas, status and log count, plus where the block's total fees went — instead of one receipt read per transaction. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-receipts?chain=base&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block_receipts",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"aggregatedOver": {
"type": "integer"
},
"blockNumber": {
"type": "integer"
},
"cap": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"failedCount": {
"type": "integer"
},
"feesPaidNative": {
"type": "string"
},
"feesPaidWei": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"successCount": {
"type": "integer"
},
"totalGasUsed": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
},
"uniqueSenders": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "Height, timestamp, transaction count, gas used and base fee for up to 25 consecutive blocks — the series itself, so a caller can plot throughput or fee pressure instead of taking our word for the average. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-series?chain=base&blocks=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"description": "how many blocks, newest first (max 25) (default 10)",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block_series",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"secondsPerBlock": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"window": {
"additionalProperties": {},
"type": "object"
}
},
"type": "object"
}
},
{
"description": "Seconds per block and blocks per hour, taken from the timestamps of two real headers at the edges of a window — one stalled block shows as a wider span instead of being smoothed away. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-stats?chain=base&blocks=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"description": "window size in blocks (bounded) (default 20)",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocksPerHour": {
"type": "number"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"type": "integer"
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"edges": {
"additionalProperties": {},
"type": "object"
},
"fromBlock": {
"type": "integer"
},
"head": {
"type": "integer"
},
"label": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"secondsPerBlock": {
"type": "number"
},
"source": {
"type": "string"
},
"spanSeconds": {
"type": "integer"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"toBlock": {
"type": "integer"
},
"ts": {
"type": "string"
},
"windowBlocks": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "Every transaction hash in one block plus the count — the step between 'which block' and 'which transfers happened', without pulling full receipts. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/block-txids?chain=base&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_block_txids",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"transactionHashes": {
"items": {},
"type": "array"
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Scans deployed bytecode for 4-byte selectors we can name from a derived table: what this contract can be asked to do, read off the code rather than trusted from a README. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/bytecode-capabilities?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&count=8.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"count": {
"description": "how many named selectors to list (max 60) (default 40)",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_bytecode_capabilities",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"hasCode": {
"type": "boolean"
},
"named": {
"items": {},
"type": "array"
},
"namedCount": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"push4Candidates": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"unnamedSelectorCount": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "SHA-256 of the deployed bytecode plus its size and edges — two addresses with the same fingerprint are the same compiled contract, which is how a clone of a known scam shows up before you interact with it. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/bytecode-fingerprint?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_bytecode_fingerprint",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"hasCode": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"prefix": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"sha256": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"suffix": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_call with your own calldata against one pinned public node: raw return data plus its decoded uint/address forms. The escape hatch for any view function we did not wrap. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/call?chain=base&to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&data=0x95d89b41&blockTag=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockTag": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"data": {
"description": "hex calldata, even digits, max 4096 bytes [required]",
"type": "string"
},
"to": {
"description": "contract address to call [required]",
"type": "string"
}
},
"required": [
"chain",
"to",
"data"
],
"type": "object"
},
"name": "chain_call",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asAddress": {
"type": [
"string",
"null"
]
},
"asString": {
"type": "string"
},
"asUint": {
"type": "string"
},
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"returnData": {
"type": "string"
},
"returnSize": {
"type": "integer"
},
"returnedNoData": {
"type": "boolean"
},
"reverted": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"to": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "web3_clientVersion for the node that served the call — the build string is how you tell reth from erigon from a proxy that is silently serving a different chain. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/client-version?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_client_version",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answeredBy": {
"description": "host that replied",
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"clientVersion": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getCode size check: bytecode length plus whether the address is a contract at all — the two-second answer to 'did I just send funds to an EOA'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/code?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_code",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"bytecodeSize": {
"description": "bytes of deployed code",
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"codePrefix": {
"type": "string"
},
"isContract": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getCode at a historical block, compared against today: bytecode present then, size at both points, and whether the code changed since. The check for 'what did this address look like when I traded'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/code-at?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_code_at",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"block": {
"type": "string"
},
"blockNumber": {
"type": "integer"
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"changedSince": {
"type": "boolean"
},
"codePrefix": {
"type": "string"
},
"existedAtBlock": {
"type": "boolean"
},
"isContractNow": {
"type": "boolean"
},
"latestBytecodeSize": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Bytecode size plus every supported-interface answer in one call — the pre-flight that tells an agent whether a 'token' address is a contract at all and which standards it claims. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/contract-check?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "contract to fingerprint [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_contract_check",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"codePrefix": {
"type": "string"
},
"isContract": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"supports": {
"additionalProperties": {},
"type": "object"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Bytecode fingerprints of two addresses compared: size, SHA-256 and prefix/suffix equality — the question behind 'is this new token a redeploy of the one that ruggened last week'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/contract-diff?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&other=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"other": {
"description": "second address to compare against [required]",
"type": "string"
}
},
"required": [
"chain",
"address",
"other"
],
"type": "object"
},
"name": "chain_contract_diff",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"a": {
"additionalProperties": {},
"type": "object"
},
"b": {
"additionalProperties": {},
"type": "object"
},
"bothHaveCode": {
"type": "boolean"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"identicalBytecode": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"sameSize": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "owner() decoded, plus whether the same address answers owner() as a storage read — the single field that decides who can pause, mint or upgrade the thing you are about to interact with. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/contract-owner?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_contract_owner",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"hasCode": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "gasPrice, base fee, priority fee and the all-in cost of a 21000-gwei native transfer in wei and native units — what sending costs right now, on one chain. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/fee-data?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_fee_data",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"baseFeeGwei": {
"type": "number"
},
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"gasPriceGwei": {
"type": "number"
},
"maxPriorityFeeGwei": {
"type": "number"
},
"nativeSymbol": {
"type": "string"
},
"nativeTransferCost": {
"additionalProperties": {},
"type": "object"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_feeHistory over a bounded window: base fee at every block plus the 25/50/75 priority-fee percentiles. Whether gas is RISING is not answerable from one instantaneous quote, which is what /chain/fee-data gives. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/fee-history?chain=base&blocks=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"description": "window size in blocks (bounded) (default 20)",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_fee_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"baseFeeGwei": {
"additionalProperties": {},
"type": "object"
},
"blocksCovered": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"gasUsedRatio": {
"items": {},
"type": "array"
},
"head": {
"type": "integer"
},
"label": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"oldestBlock": {
"type": "integer"
},
"perBlockBaseFeeGwei": {
"items": {},
"type": "array"
},
"priorityFeeGwei": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trendPct": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_estimateGas for a transfer or contract call you describe — the exact simulation a wallet runs before signing, without needing a wallet. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/gas-estimate?chain=base&to=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&from=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&data=0x95d89b41&value=0.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"data": {
"description": "hex calldata (default \"0x\")",
"type": "string"
},
"from": {
"description": "simulation caller address",
"type": "string"
},
"to": {
"description": "contract address to call [required]",
"type": "string"
},
"value": {
"description": "native value in wei (decimal) (default 0)",
"type": "string"
}
},
"required": [
"chain",
"to"
],
"type": "object"
},
"name": "chain_gas_estimate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"atSenderGas": {
"additionalProperties": {},
"type": "object"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"estimable": {
"type": "boolean"
},
"gasEstimate": {
"type": "string"
},
"gasPriceGwei": {
"type": "number"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"to": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Latest block, its age in seconds, base fee and block fullness for up to 4 chains in one paid call — the fastest answer to 'which of these chains is actually caught up right now'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/heads?chains=base,ethereum.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chains": {
"description": "comma list, up to 4: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche (default [\"base\"])",
"type": "string"
}
},
"type": "object"
},
"name": "chain_heads",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"chains": {
"items": {},
"type": "array"
},
"note": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"description": "one entry per chain",
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getLogs over a bounded window (max 1000 blocks) with an address and/or first topic — transfers and events without running an indexer. Refuses an unfiltered scan. Walks the window in chunks because a free node refuses a big one on response size, and reports any range no node would serve instead of failing a settled call. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/logs?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&topic0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef&fromBlock=5000&toBlock=5999.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "contract that emitted the events",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"fromBlock": {
"description": "first block number to scan (inclusive) [required]",
"type": "string"
},
"toBlock": {
"description": "last block number (default: current head); range capped at 1000 blocks",
"type": "string"
},
"topic0": {
"description": "first event topic, 0x + 64 hex",
"type": "string"
}
},
"required": [
"chain",
"fromBlock"
],
"type": "object"
},
"name": "chain_logs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"chunks": {
"additionalProperties": {},
"type": "object"
},
"count": {
"type": "integer"
},
"nodeCalls": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"range": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Batched eth_call: ten (target, calldata) pairs settled once, each answered independently so one reverting view cannot fail the rest. A tenth of the per-call cost of doing them one at a time. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/multicall?chain=base&calls=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:0x95d89b41,0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:0x18160ddd&blockTag=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockTag": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"calls": {
"description": "up to 10 pairs, formatted 0xTo:0xCalldata,comma separated [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"calls"
],
"type": "object"
},
"name": "chain_multicall",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"answered": {
"type": "integer"
},
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_chainId versus net_version for one chain. A mismatch is how a wallet ends up signing Base transactions for Mainnet, so this is a two-call safety check, not trivia. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/network-id?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_network_id",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"agree": {
"type": "boolean"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"type": "integer"
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"expectedChainId": {
"type": "integer"
},
"matchesOurConfig": {
"type": "boolean"
},
"netVersion": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "getApproved(tokenId) — the single-operator approval on one id. Non-zero means someone other than the owner can transfer that exact token without owning it. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-approved?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"tokenId"
],
"type": "object"
},
"name": "chain_nft_approved",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"approved": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"hasApproval": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "isApprovedForAll(owner, operator) — the setApprovalForAll permission behind most NFT drain headlines, answered per pair in one paid call. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-approved-for-all?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&operator=0x0000000000000000000000000000000000000000.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"operator": {
"description": "delegate/operator address being tested [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owner",
"operator"
],
"type": "object"
},
"name": "chain_nft_approved_for_all",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"approved": {
"type": "boolean"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"operator": {
"type": "string"
},
"owner": {
"type": "string"
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "balanceOf(owner) on an NFT contract — how many ids one wallet holds, without indexing every transfer. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-balance?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owner"
],
"type": "object"
},
"name": "chain_nft_balance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"balance": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"overflow": {
"type": "boolean"
},
"owner": {
"type": "string"
},
"raw": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "name/symbol plus which token standards the contract actually claims (ERC-165, ERC-721, ERC-721Metadata, ERC-1155) via supportsInterface. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-meta?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_nft_meta",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"supports": {
"additionalProperties": {},
"type": "object"
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "ownerOf(tokenId) resolved for one NFT — proof of who holds a specific id right now, from the contract itself. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-owner?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"tokenId"
],
"type": "object"
},
"name": "chain_nft_owner",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "ownerOf(id) read at a chosen block and again at the head: previous holder, current holder, and whether it moved — the ownership history a sale-attribution or stolen-collection check needs. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-owner-at?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "older block number or tag to compare the current owner against [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"tokenId",
"block"
],
"type": "object"
},
"name": "chain_nft_owner_at",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockThen": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"moved": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"ownerNow": {
"type": "string"
},
"ownerThen": {
"type": "string"
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The metadata pointer a wallet will follow for a specific id, plus whether it is on-chain JSON or an off-host scheme. The string is returned as text — this endpoint never resolves it. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nft-token-uri?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenId=1.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "NFT contract address [required]",
"type": "string"
},
"tokenId": {
"description": "token id (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"tokenId"
],
"type": "object"
},
"name": "chain_nft_token_uri",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"fetchedByUs": {
"type": "boolean"
},
"found": {
"type": "boolean"
},
"host": {
"type": [
"string",
"null"
]
},
"isOnChainJson": {
"type": "boolean"
},
"length": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"scheme": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"tokenId": {
"type": "string"
},
"tokenUri": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getTransactionCount at any block tag — what an agent needs before it builds a transaction, and how a bot detects a stuck or reused nonce. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/nonce?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&blockTag=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"blockTag": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_nonce",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"nonce": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "paused() with the revert and no-data cases kept apart from a false — 'this token has no pause switch' and 'this token is not paused' are different facts to trade on. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/paused-check?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_paused_check",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"paused": {
"type": "boolean"
},
"raw": {
"type": "string"
},
"readable": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "DOMAIN_SEPARATOR() plus the owner's current nonce and whether permit() is in the code — the three inputs a signed-approval relayer needs before it can move funds without the holder paying gas. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/permit-ready?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "address whose permit nonce to read [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owner"
],
"type": "object"
},
"name": "chain_permit_ready",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"domainSeparator": {
"type": "string"
},
"hasPermitSelector": {
"type": "boolean"
},
"implementation": {
"type": "string"
},
"nonce": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"permitReady": {
"type": "boolean"
},
"permitSelectorIn": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The three EIP-1967 slots (implementation, admin, beacon) read next to implementation(): a proxy hides the real code, so bytecode-size checks alone understate what an upgrade can change. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/proxy-check?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_proxy_check",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"beacon": {
"type": [
"string",
"null"
]
},
"bytecodeSize": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"eip1967Slots": {
"additionalProperties": {},
"type": "object"
},
"hasCode": {
"type": "boolean"
},
"implementationFromCall": {
"type": "string"
},
"implementationFromSlot": {
"type": "string"
},
"isProxy": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"proxyAdmin": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"slotMatchesCall": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Status, gasUsed, effective gas price, contract created, log count and live confirmations for one hash — whether a transaction actually landed and what it cost. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/receipt?chain=base&hash=0x55bd09129b86846556030b6036d48c75865b1f8e73ee6f7df60a22a56f3cd0d4.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"hash": {
"description": "transaction hash, 0x + 64 hex [required]",
"type": "string"
}
},
"required": [
"chain",
"hash"
],
"type": "object"
},
"name": "chain_receipt",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"confirmations": {
"type": "integer"
},
"contractAddress": {
"type": [
"string",
"null"
]
},
"costWei": {
"type": "string"
},
"cumulativeGasUsed": {
"type": "string"
},
"effectiveGasPriceGwei": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"from": {
"type": "string"
},
"gasUsed": {
"type": "string"
},
"logCount": {
"type": "integer"
},
"logsBloomPresent": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"status": {
"description": "1 = success",
"type": "integer"
},
"to": {
"type": "string"
},
"transactionHash": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getStorageAt for one slot of one account — verify a contract's own bookkeeping (owner slot, mapping entry) instead of trusting a view function. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/storage?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&slot=0x0&blockTag=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"blockTag": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"slot": {
"description": "storage slot (hex, up to 32 bytes) [required]",
"type": "string"
}
},
"required": [
"chain",
"address",
"slot"
],
"type": "object"
},
"name": "chain_storage",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"asAddress": {
"type": "string"
},
"asUint": {
"type": "string"
},
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"slot": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"value": {
"description": "32-byte word",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The same slot read at two blocks: previous, current, and whether they differ — the primitive behind 'what did this contract's state actually move between those two dates'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/storage-diff?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&slot=0x0&blockA=latest&blockB=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"blockA": {
"description": "older block (number or latest|safe|finalized|earliest) (default \"safe\")",
"type": "string"
},
"blockB": {
"description": "newer block (number or tag) (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"slot": {
"description": "storage slot (hex, up to 32 bytes) [required]",
"type": "string"
}
},
"required": [
"chain",
"address",
"slot"
],
"type": "object"
},
"name": "chain_storage_diff",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"asUintA": {
"type": "string"
},
"asUintB": {
"type": "string"
},
"blocks": {
"additionalProperties": {},
"type": "object"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"changed": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"slot": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"valueA": {
"type": "string"
},
"valueB": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Up to 16 consecutive 32-byte words from any starting slot — walk a struct or the array behind a mapping instead of trusting one view function to explain itself. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/storage-range?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&fromSlot=0x0&count=8&blockTag=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "contract whose storage is read [required]",
"type": "string"
},
"blockTag": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"count": {
"description": "how many items to read (bounded) (default 8)",
"type": "string"
},
"fromSlot": {
"description": "first storage slot (hex, up to 32 bytes) (default \"0x0\")",
"type": "string"
}
},
"required": [
"chain",
"address"
],
"type": "object"
},
"name": "chain_storage_range",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"fromSlot": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"populated": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "totalSupply read at any block and diffed against now, formatted with the token's own decimals — how much of a supply was minted since a date, without an indexer. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/supply-at?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_supply_at",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"atBlockFormatted": {
"type": "string"
},
"atBlockRaw": {
"type": "string"
},
"block": {
"type": "string"
},
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"changePct": {
"type": "number"
},
"decimals": {
"type": "integer"
},
"decimalsAssumed": {
"type": "boolean"
},
"deltaFormatted": {
"type": "string"
},
"deltaRaw": {
"type": "string"
},
"direction": {
"type": "string"
},
"latestFormatted": {
"type": "string"
},
"latestRaw": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_syncing plus the head: a public node that is quietly 300 blocks behind answers every other question with stale data, and nothing else in a response tells you that. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/sync-status?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_sync_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"currentBlock": {
"type": "integer"
},
"finalizedBlock": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"head": {
"type": "integer"
},
"highestBlock": {
"type": "integer"
},
"lagBlocks": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"safeBlock": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"syncing": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "balanceOf plus the token's own decimals, formatted — a human-readable USDC/token balance, not a raw 18-digit integer that needs a calculator. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/token-balance?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owner"
],
"type": "object"
},
"name": "chain_token_balance",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"decimalsAssumed": {
"type": "boolean"
},
"formatted": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"raw": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "balanceOf for up to 20 wallets on the same ERC-20, with decimals and symbol resolved once — the holder snapshot a distribution or listing check needs, in one settlement. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/token-balances?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&owners=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0xa0b86991C6218A36cDD3b2C3d5E0F5b8D2f0A11C.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owners": {
"description": "comma list of up to 20 holder addresses [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"owners"
],
"type": "object"
},
"name": "chain_token_balances",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"decimalsAssumed": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"readableCount": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"sumFormatted": {
"type": "string"
},
"sumRaw": {
"type": "string"
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The four ERC-20 view calls a listing needs, in one paid call, each tolerant of a token that does not implement it. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/token-meta?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_token_meta",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"isContract": {
"type": "boolean"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"totalSupply": {
"type": "string"
},
"totalSupplyFormatted": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The ERC-20 listing fields read at a past block tag or height, formatted with the decimals the contract itself reported — how a supply looked on a date, not how it looks now. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/token-meta-at?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or tag to read the listing fields at [required]",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token",
"block"
],
"type": "object"
},
"name": "chain_token_meta_at",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"decimals": {
"type": "integer"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"token": {
"type": "string"
},
"totalSupply": {
"type": "string"
},
"totalSupplyRaw": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Transfer events for one token over a short window, decoded from/to/amount with the token's decimals applied — the outflow check a monitoring bot wants first, without running an indexer. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/transfers-scan?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&blocks=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"description": "window size in blocks (bounded) (default 10)",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"token": {
"description": "token / NFT contract address [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "chain_transfers_scan",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"decimals": {
"type": "integer"
},
"decimalsAssumed": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"range": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"sumFormatted": {
"type": "string"
},
"sumRaw": {
"type": "string"
},
"token": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Value locked in USD per chain, ranked. TVL is a protocol-reported metric, not a risk measure. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "chain_tvl",
"outputSchema": null
},
{
"description": "eth_getTransactionByHash decoded to the fields a caller branches on: from, to, value, nonce, gas, calldata length and inclusion block. Reports found:false rather than inventing a zero. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/tx?chain=base&hash=0x55bd09129b86846556030b6036d48c75865b1f8e73ee6f7df60a22a56f3cd0d4.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"hash": {
"description": "transaction hash, 0x + 64 hex [required]",
"type": "string"
}
},
"required": [
"chain",
"hash"
],
"type": "object"
},
"name": "chain_tx",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"pending": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"transaction": {
"additionalProperties": {},
"type": "object"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getTransactionByBlockNumberAndIndex — pick the Nth transaction of a block without transferring the whole block, which is how you sample a block instead of downloading it. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/tx-at-index?chain=base&block=latest&index=0.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"index": {
"description": "transaction index inside the block (decimal) [required]",
"type": "string"
}
},
"required": [
"chain",
"index"
],
"type": "object"
},
"name": "chain_tx_at_index",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"index": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"transaction": {
"additionalProperties": {},
"type": "object"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "eth_getBlockTransactionCountByNumber for one block tag or height — the cheapest load/throughput reading of a chain that never has to move a full block header over the wire. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/tx-count?chain=base&block=latest.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"block": {
"description": "block number or latest|safe|finalized|earliest|pending (default \"latest\")",
"type": "string"
},
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
}
},
"required": [
"chain"
],
"type": "object"
},
"name": "chain_tx_count",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockTag": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The receipt's logs decoded to address, topic0, indexed values and data size — what a transaction actually did, straight from the node, which is the only honest answer when eth_getLogs by transaction hash is refused. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/tx-events?chain=base&hash=0x55bd09129b86846556030b6036d48c75865b1f8e73ee6f7df60a22a56f3cd0d4.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"hash": {
"description": "transaction hash, 0x + 64 hex [required]",
"type": "string"
}
},
"required": [
"chain",
"hash"
],
"type": "object"
},
"name": "chain_tx_events",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"hash": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": "integer"
},
"truncated": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "One call for the pair every bot needs after sending: the transaction plus its receipt, with confirmations, block, status, gas used and revert reason together — instead of two paid reads and a race. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/tx-status?chain=base&hash=0x55bd09129b86846556030b6036d48c75865b1f8e73ee6f7df60a22a56f3cd0d4.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"hash": {
"description": "transaction hash, 0x + 64 hex [required]",
"type": "string"
}
},
"required": [
"chain",
"hash"
],
"type": "object"
},
"name": "chain_tx_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blockNumber": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"confirmations": {
"type": "integer"
},
"contractAddress": {
"type": [
"string",
"null"
]
},
"effectiveGasPriceGwei": {
"type": "integer"
},
"failed": {
"type": "boolean"
},
"found": {
"type": "boolean"
},
"from": {
"type": "string"
},
"gasUsed": {
"type": "string"
},
"hash": {
"type": "string"
},
"logCount": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"pending": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"revertReason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": "integer"
},
"to": {
"type": "string"
},
"ts": {
"type": "string"
},
"valueWei": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "allowance(owner, spender) across up to 10 tokens for one wallet — the standing-approval audit that answers 'if this address gets phished tonight, what leaves'. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/wallet-approvals?chain=base&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&spender=0x0000000000000000000000000000000000000000&tokens=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"spender": {
"description": "allowance spender address [required]",
"type": "string"
},
"tokens": {
"description": "comma list of up to 10 ERC-20/ERC-721 contract addresses [required]",
"type": "string"
}
},
"required": [
"chain",
"owner",
"spender",
"tokens"
],
"type": "object"
},
"name": "chain_wallet_approvals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"openApprovals": {
"type": "integer"
},
"owner": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"spender": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"unrestrictedApprovals": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "ERC-721 balanceOf for one address across up to 10 collections with each collection's name and symbol resolved once — the 'what NFTs does this wallet actually hold' check without an indexer. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/wallet-nfts?chain=base&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokens=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"tokens": {
"description": "up to 10 ERC-721 contract addresses [required]",
"type": "string"
}
},
"required": [
"chain",
"owner",
"tokens"
],
"type": "object"
},
"name": "chain_wallet_nfts",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"collectionsWithHoldings": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"totalHeld": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Balance, nonce and contract/EOA flag for one address on up to 4 chains in a single paid call — the one-shot 'what does this wallet actually hold' check. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/wallet-state?chains=base,ethereum&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chains": {
"description": "comma list, up to 4: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche (default [\"base\"])",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "chain_wallet_state",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"chains": {
"items": {},
"type": "array"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "balanceOf for one address across up to 10 tokens on one chain, each formatted with its own decimals and symbol — the holding snapshot a portfolio bot wants in a single settlement instead of ten. Costs $0.001 USDC per call. Chains: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche. Byte-identical to GET /chain/wallet-tokens?chain=base&owner=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokens=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913,0x4200000000000000000000000000000000000006.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key: base, ethereum, arbitrum, bsc, polygon, optimism, avalanche [required]",
"type": "string"
},
"owner": {
"description": "holder address [required]",
"type": "string"
},
"tokens": {
"description": "comma list of up to 10 ERC-20/ERC-721 contract addresses [required]",
"type": "string"
}
},
"required": [
"chain",
"owner",
"tokens"
],
"type": "object"
},
"name": "chain_wallet_tokens",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"chainId": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"chainLabel": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"owner": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"tokensReadable": {
"type": "integer"
},
"totalRowsWithBalance": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Runs the scanner on a small built-in bad-bot sample and returns the findings. Free; no x402 payment.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "demo_audit",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"demo": {
"type": "boolean"
},
"findings": {
"items": {
"additionalProperties": {},
"type": "object"
},
"type": "array"
},
"signalCount": {
"type": "integer"
}
},
"required": [
"demo",
"signalCount",
"findings"
],
"type": "object"
}
},
{
"description": "Gas price, base fee and block height for Base and Arbitrum from public RPC — what a transaction costs before you send it. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chains": {
"items": {
"enum": [
"base",
"arbitrum"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
}
},
"type": "object"
},
"name": "gas_prices",
"outputSchema": null
},
{
"description": "Live DEX spot price, liquidity, FDV, market cap and 24h volume for any token by contract address — EVM (Base/etc.) or Solana mint. Highest-liquidity pair. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "Token contract address: EVM (0x…, 42 hex) or Solana base58 mint (32-44 chars)",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "get_token_price",
"outputSchema": null
},
{
"description": "Candles for a Bitfinex spot pair at the timeframes its v2 API serves, oldest first, with base volume per bucket. Costs $0.001 USDC per call. Byte-identical to GET /market/bfex-candles?pair=BTCUSD&timeframe=1m&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "candles (max 300) (default 48)",
"type": "string"
},
"pair": {
"description": "Bitfinex currency pair without the venue's leading t: BTCUSD, ETHUSD, ADAUSD [required]",
"type": "string"
},
"timeframe": {
"description": "Bitfinex candle timeframe (default \"1m\")",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_bfex_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timeframe": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The pair ids Bitfinex itself publishes for its spot exchange, optionally filtered by a substring — the lookup that stops a bot guessing a market that does not exist. Costs $0.001 USDC per call. Byte-identical to GET /market/bfex-pairs?contains=USD&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contains": {
"description": "case-insensitive substring filter on the pair id (default null)",
"type": "string"
},
"limit": {
"description": "ids to return (max 300) (default 100)",
"type": "string"
}
},
"type": "object"
},
"name": "market_bfex_pairs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"matched": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"pairs": {
"items": {},
"type": "array"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"total": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Top of book, last, 24h change in price and percent, and 24h volume/high/low for one Bitfinex spot pair. Costs $0.001 USDC per call. Byte-identical to GET /market/bfex-ticker?pair=BTCUSD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pair": {
"description": "Bitfinex currency pair without the venue's leading t: BTCUSD, ETHUSD, ADAUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_bfex_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ask": {
"type": "integer"
},
"askSize": {
"type": "number"
},
"bid": {
"type": "integer"
},
"bidSize": {
"type": "number"
},
"caveat": {
"type": [
"string",
"null"
]
},
"change24h": {
"type": "integer"
},
"changePct24h": {
"type": "number"
},
"found": {
"type": "boolean"
},
"high24h": {
"type": "integer"
},
"last": {
"type": "integer"
},
"low24h": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"volume24h": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Per-block projection for the mempool's next ~8 blocks: size, transaction count, total fees, median fee and the fee-rate range that would make it. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-block-projections?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "projected blocks to return (the venue publishes about 8) (default 8)",
"type": "string"
}
},
"type": "object"
},
"name": "market_btc_block_projections",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The current Bitcoin block height as mempool.space sees it, plus the best tip hash — the two-second liveness check for anything Bitcoin-facing. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-chain-tip?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_btc_chain_tip",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"height": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"tipHash": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Where the next difficulty adjustment stands: percent progress, projected change, remaining blocks and time, the next retarget height and the average block time behind it. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-difficulty-adjustment?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_btc_difficulty_adjustment",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"adjustedTimeAvgSec": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"difficultyChange": {
"type": "number"
},
"estimatedRetargetMs": {
"type": "integer"
},
"expectedBlocks": {
"type": "number"
},
"nextRetargetHeight": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"previousRetarget": {
"type": "number"
},
"previousTimeMs": {
"type": "integer"
},
"progressPercent": {
"type": "number"
},
"reason": {
"type": [
"string",
"null"
]
},
"remainingBlocks": {
"type": "integer"
},
"remainingTimeMs": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timeAvgSec": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The recommended sat-per-vbyte fee targets for the next blocks: fastest, half-hour, one-hour, economy and minimum. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-fee-estimates?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_btc_fee_estimates",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"economyFee": {
"type": "integer"
},
"fastestFee": {
"type": "integer"
},
"halfHourFee": {
"type": "integer"
},
"hourFee": {
"type": "integer"
},
"minimumFee": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Network hashrate points and the difficulty-adjustment series over a bounded window, with the current hashrate and difficulty the explorer reports. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-mining-hashrate?window=1m&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "points per series to return (max 400) (default 60)",
"type": "string"
},
"window": {
"description": "history window (only the values measured) (default \"1m\")",
"type": "string"
}
},
"type": "object"
},
"name": "market_btc_mining_hashrate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"currentDifficulty": {
"type": "number"
},
"currentHashrateHs": {
"type": "string"
},
"difficulty": {
"items": {},
"type": "array"
},
"difficultyPoints": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"hashratePoints": {
"type": "integer"
},
"hashrates": {
"items": {},
"type": "array"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"window": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "One shot at the network's aggregate state: price, hash rate, difficulty, next retarget height, blocks and transactions in the last day, coins mined, fees collected and total supply. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-network-stats?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_btc_network_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocksSize": {
"type": "integer"
},
"btcMinedSats": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"difficulty": {
"type": "integer"
},
"estimatedBtcSent": {
"type": "integer"
},
"estimatedTxVolumeUsd": {
"type": "number"
},
"hashRateGh": {
"type": "number"
},
"marketPriceUsd": {
"type": "number"
},
"minutesBetweenBlocks": {
"type": "number"
},
"nBlocksMined": {
"type": "integer"
},
"nBlocksTotal": {
"type": "integer"
},
"nTx": {
"type": "integer"
},
"nextRetargetHeight": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timestampMs": {
"type": "integer"
},
"totalBtcSats": {
"type": "integer"
},
"totalBtcSent": {
"type": "integer"
},
"totalFeesSats": {
"type": "integer"
},
"tradeVolumeBtc": {
"type": "number"
},
"tradeVolumeUsd": {
"type": "number"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The blocks a Bitcoin explorer has just indexed: height, hash, time, difficulty, transaction count, size and weight, with the mined fees and pool name when the explorer attaches them. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-recent-blocks?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "blocks to return (the endpoint publishes about 15) (default 10)",
"type": "string"
}
},
"type": "object"
},
"name": "market_btc_recent_blocks",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"blocks": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"tipHeight": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The reference BTC price in USD plus six other fiat currencies with the quote timestamp — as a Bitcoin-native explorer publishes it, not as a venue tape. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-spot-prices?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_btc_spot_prices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"aud": {
"type": "integer"
},
"cad": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chf": {
"type": "integer"
},
"eur": {
"type": "integer"
},
"gbp": {
"type": "integer"
},
"jpy": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timeSec": {
"type": "integer"
},
"ts": {
"type": "string"
},
"usd": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "Daily BTC/USD closes back to the earliest point the explorer keeps, downsampled to a bounded number of points — a long-run price series without a key. Costs $0.001 USDC per call. Byte-identical to GET /market/btc-usd-price-history?timespan=6months&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "points to return (newest first slice, max 500) (default 120)",
"type": "string"
},
"timespan": {
"description": "history window (1month is rejected upstream and is therefore not offered) (default \"6months\")",
"type": "string"
}
},
"type": "object"
},
"name": "market_btc_usd_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timespan": {
"type": "string"
},
"total": {
"type": "integer"
},
"ts": {
"type": "string"
},
"unit": {
"type": "string"
},
"values": {
"items": {},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Level-1 book for a Coinbase product: the single best bid, the single best ask, their sizes and the book sequence number. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-best-quote?product=BTC-USD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_best_quote",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"askSize": {
"type": "string"
},
"auctionMode": {
"type": "boolean"
},
"bestAsk": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bidSize": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"product": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"sequence": {
"type": "integer"
},
"source": {
"type": "string"
},
"spread": {
"type": "number"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"time": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Candles from Coinbase Exchange for the granularities its API serves (1m to 1d), oldest first, with volume per bucket. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-candles?product=BTC-USD&granularity=60&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"granularity": {
"description": "candle width in seconds (default \"60\")",
"type": "string"
},
"limit": {
"description": "candles to return (max 350, the venue's own page size) (default 48)",
"type": "string"
},
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"granularity": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"product": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The venue's own server time plus the offset against this server — the check that stops a signed order being rejected for clock drift. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-clock?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_cbex_clock",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"epoch": {
"type": "number"
},
"iso": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"roundTripMs": {
"type": "integer"
},
"skewMs": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The venue's own rules for one product: tick and lot size, minimum order, whether it is margin/post-only/limit-only, and whether trading is enabled. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-product-spec?product=BTC-USD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_product_spec",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"auctionMode": {
"type": "boolean"
},
"base": {
"type": "string"
},
"baseIncrement": {
"type": "string"
},
"cancelOnly": {
"type": "boolean"
},
"caveat": {
"type": [
"string",
"null"
]
},
"display": {
"type": "string"
},
"found": {
"type": "boolean"
},
"fxStablecoin": {
"type": "boolean"
},
"highBidLimitPct": {
"type": "string"
},
"id": {
"type": "string"
},
"limitOnly": {
"type": "boolean"
},
"marginEnabled": {
"type": "boolean"
},
"maxSlippagePct": {
"type": "string"
},
"minMarketFunds": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"postOnly": {
"type": "boolean"
},
"quote": {
"type": "string"
},
"quoteIncrement": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": "string"
},
"statusMessage": {
"type": "string"
},
"tradingDisabled": {
"type": "boolean"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Open, high, low, last and both the 24h and 30-day traded volume for a Coinbase product — what a session actually cost and moved. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-stats?product=BTC-USD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"change24hPct": {
"type": "number"
},
"found": {
"type": "boolean"
},
"high": {
"type": "string"
},
"last": {
"type": "string"
},
"low": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"open": {
"type": "string"
},
"product": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"volume24h": {
"type": "string"
},
"volume30d": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Last trade, top of book, 24h volume and the exchange's own clock for one Coinbase product. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-ticker?product=BTC-USD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ask": {
"type": "string"
},
"bid": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"price": {
"type": "string"
},
"product": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"size": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"time": {
"type": "string"
},
"tradeId": {
"type": "integer"
},
"ts": {
"type": "string"
},
"volume": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Public fill feed for a Coinbase product: price, size, side, timestamp and trade id, newest first. Costs $0.001 USDC per call. Byte-identical to GET /market/cbex-trades?product=BTC-USD&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "trades to return (max 200) (default 25)",
"type": "string"
},
"product": {
"description": "Coinbase Exchange product id, BASE-QUOTE (BTC-USD, ETH-USD, SOL-USD) [required]",
"type": "string"
}
},
"required": [
"product"
],
"type": "object"
},
"name": "market_cbex_trades",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"product": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trades": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The funding Deribit's own get_funding_rate_value reports as having accrued on one instrument between two timestamps — a window total, not a snapshot rate. Costs $0.001 USDC per call. Byte-identical to GET /market/deribit-funding-window?instrument=BTC-PERPETUAL&hours=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"hours": {
"description": "look-back window in whole hours (max 720) (default 24)",
"type": "string"
},
"instrument": {
"description": "Deribit instrument name, CURRENCY-SUFFIX (BTC-PERPETUAL, ETH-25SEP26) [required]",
"type": "string"
}
},
"required": [
"instrument"
],
"type": "object"
},
"name": "market_deribit_funding_window",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"annualizedPct": {
"type": "number"
},
"caveat": {
"type": [
"string",
"null"
]
},
"endMs": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"fundingOverWindow": {
"type": "number"
},
"hours": {
"type": "integer"
},
"instrument": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"startMs": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Deribit's own index price for an underlying plus the estimated delivery price it settles against — the reference a funding or settlement check needs. Costs $0.001 USDC per call. Byte-identical to GET /market/deribit-index?indexName=btc_usd.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"indexName": {
"description": "Deribit index name (only the ones measured) (default \"btc_usd\")",
"type": "string"
}
},
"type": "object"
},
"name": "market_deribit_index",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"estimatedDeliveryPrice": {
"type": "number"
},
"found": {
"type": "boolean"
},
"indexName": {
"type": "string"
},
"indexPrice": {
"type": "number"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The contract rules Deribit publishes per instrument: tick size, contract size, min trade amount, max leverage, fee rates, state and expiry — perpetuals only or the whole listed futures set. Costs $0.001 USDC per call. Byte-identical to GET /market/deribit-instruments?currency=BTC&family=perpetual&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"description": "currency to list instruments for (default \"BTC\")",
"type": "string"
},
"family": {
"description": "just -PERPETUAL, or every listed future including dated ones (default \"perpetual\")",
"type": "string"
},
"limit": {
"description": "instruments to return (max 50) (default 12)",
"type": "string"
}
},
"type": "object"
},
"name": "market_deribit_instruments",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"currency": {
"type": "string"
},
"family": {
"type": "string"
},
"found": {
"type": "boolean"
},
"listed": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Historical daily candles of Deribit's DVOL-style volatility index for an underlying — the implied-vol level options are priced off, as OHLC per day. Costs $0.001 USDC per call. Byte-identical to GET /market/deribit-volatility-index?currency=BTC&days=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"description": "underlying whose volatility index Deribit publishes (default \"BTC\")",
"type": "string"
},
"days": {
"description": "days of history (max 365) (default 30)",
"type": "string"
}
},
"type": "object"
},
"name": "market_deribit_volatility_index",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"currency": {
"type": "string"
},
"days": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The tokens currently promoted on DexScreener, with the chain, token address, the description and links the submitter provided and the boost amount and timing — what is being pushed, not what has liquidity. Costs $0.001 USDC per call. Byte-identical to GET /market/dex-boosted-tokens?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "entries to return (max 30) (default 15)",
"type": "string"
}
},
"type": "object"
},
"name": "market_dex_boosted_tokens",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Everything DexScreener publishes for a single pool: the pair's chain, dex and label, price in USD and native, liquidity split, volume and buy/sell counts per window, and 5m/1h/6h/24h price change. Costs $0.001 USDC per call. Byte-identical to GET /market/dex-pair-detail?chain=base&pair=0x5D0bC342178C8Fe2c2f9A9fcC9D52555C99936db.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "DexScreener chain id (base, ethereum, solana, …) [required]",
"type": "string"
},
"pair": {
"description": "pool / pair address on that chain [required]",
"type": "string"
}
},
"required": [
"chain",
"pair"
],
"type": "object"
},
"name": "market_dex_pair_detail",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"baseToken": {
"additionalProperties": {},
"type": "object"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"chainId": {
"type": "string"
},
"dexId": {
"type": "string"
},
"fdv": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"labels": {
"items": {},
"type": "array"
},
"liquidityBase": {
"type": "number"
},
"liquidityQuote": {
"type": "integer"
},
"liquidityUsd": {
"type": "number"
},
"marketCap": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"pairAddress": {
"type": "string"
},
"pairCreatedAtMs": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"priceChange": {
"additionalProperties": {},
"type": "object"
},
"priceNative": {
"type": "string"
},
"priceUsd": {
"type": "string"
},
"quoteToken": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"txns": {
"additionalProperties": {},
"type": "object"
},
"url": {
"type": "string"
},
"volume": {
"additionalProperties": {},
"type": "object"
}
},
"type": "object"
}
},
{
"description": "All DEX pools DexScreener knows for one token address across chains, each with price, liquidity, 24h volume, trade counts, price change, FDV and market cap. Costs $0.001 USDC per call. Byte-identical to GET /market/dex-token-pairs?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "token address, EVM 0x.. or Solana base58 mint [required]",
"type": "string"
},
"limit": {
"description": "pools to return, most liquid first (max 30) (default 10)",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "market_dex_token_pairs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"pools": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The alternative.me fear-and-greed reading: index value, its label and the seconds until the next update, for today or a whole history back to 365 days. Costs $0.001 USDC per call. Byte-identical to GET /market/fear-greed-index?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "daily readings to return, newest first (max 365) (default 1)",
"type": "string"
}
},
"type": "object"
},
"name": "market_fear_greed_index",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"latestClassification": {
"type": "string"
},
"latestValue": {
"type": "integer"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"timeUntilUpdateSec": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "OHLCV per bucket from Gate with the quote volume and the window-closed flag, oldest first. Costs $0.001 USDC per call. Byte-identical to GET /market/gate-candles?pair=BTC_USDT&interval=5m&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"interval": {
"description": "Gate candle interval (only the values its API accepted when measured) (default \"5m\")",
"type": "string"
},
"limit": {
"description": "candles (max 1000) (default 48)",
"type": "string"
},
"pair": {
"description": "Gate currency_pair, BASE_QUOTE [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_gate_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"currency_pair": {
"type": "string"
},
"found": {
"type": "boolean"
},
"interval": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Resting bids and asks from Gate for one pair, with the venue's own sequence fields and the derived top-of-book spread. Costs $0.001 USDC per call. Byte-identical to GET /market/gate-depth?pair=BTC_USDT&levels=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"levels": {
"description": "levels per side (max 50) (default 10)",
"type": "string"
},
"pair": {
"description": "Gate currency_pair, BASE_QUOTE [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_gate_depth",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asks": {
"items": {},
"type": "array"
},
"bestAsk": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bids": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"currency_pair": {
"type": "string"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"spreadPct": {
"type": "number"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"updateMs": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "How Gate defines a currency pair: base and quote, the flat fee percent, order-size floors and caps, precision and whether it is tradable. Costs $0.001 USDC per call. Byte-identical to GET /market/gate-pair-spec?pair=BTC_USDT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pair": {
"description": "Gate currency_pair, BASE_QUOTE [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_gate_pair_spec",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount_precision": {
"type": "integer"
},
"base": {
"type": "string"
},
"base_name": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"down_rate": {
"type": "number"
},
"fee": {
"type": "string"
},
"found": {
"type": "boolean"
},
"id": {
"type": "string"
},
"market_order_max_money": {
"type": "string"
},
"market_order_max_stock": {
"type": "string"
},
"max_base_amount": {
"type": [
"string",
"null"
]
},
"max_quote_amount": {
"type": "string"
},
"min_base_amount": {
"type": "string"
},
"min_quote_amount": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"price_precision": {
"type": "integer"
},
"quote": {
"type": "string"
},
"quote_name": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"slippage": {
"type": "string"
},
"source": {
"type": "string"
},
"st_tag": {
"type": "boolean"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trade_quotes": {
"items": {},
"type": "array"
},
"trade_status": {
"type": "string"
},
"ts": {
"type": "string"
},
"type": {
"type": "string"
},
"up_rate": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Last, best bid and ask with size, 24h percent change and both base and quote volume for one Gate currency pair. Costs $0.001 USDC per call. Byte-identical to GET /market/gate-ticker?pair=BTC_USDT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pair": {
"description": "Gate currency_pair, BASE_QUOTE [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_gate_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base_volume": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"change_percentage": {
"type": "string"
},
"currency_pair": {
"type": "string"
},
"found": {
"type": "boolean"
},
"high_24h": {
"type": "string"
},
"highest_bid": {
"type": "string"
},
"highest_size": {
"type": "string"
},
"last": {
"type": "string"
},
"low_24h": {
"type": "string"
},
"lowest_ask": {
"type": "string"
},
"lowest_size": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"quote_volume": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Gate's public fill feed for one pair: side, price, base amount, millisecond timestamp and trade id. Costs $0.001 USDC per call. Byte-identical to GET /market/gate-trades?pair=BTC_USDT&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "trades (max 100) (default 25)",
"type": "string"
},
"pair": {
"description": "Gate currency_pair, BASE_QUOTE [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_gate_trades",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"currency_pair": {
"type": "string"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trades": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Keyless read of the public GitHub API for one repository: archived, forked, how long since the last push, open issue count, stars, license, topics — plus the flags an integrator actually acts on (archived, no license, unmaintained window). Does not read the source, the dependency tree, or anything private, and does not clone or build. Costs $0.001 USDC per call. Byte-identical to GET /market/github-repo-health?owner=modelcontextprotocol&repo=registry.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"owner": {
"description": "repository owner or org [required]",
"type": "string"
},
"repo": {
"description": "repository name [required]",
"type": "string"
}
},
"required": [
"owner",
"repo"
],
"type": "object"
},
"name": "market_github_repo_health",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"archived": {
"type": [
"boolean",
"null"
]
},
"caveat": {
"type": [
"string",
"null"
]
},
"createdAt": {
"type": [
"string",
"null"
]
},
"defaultBranch": {
"type": [
"string",
"null"
]
},
"flags": {
"items": {},
"type": "array"
},
"fork": {
"type": [
"boolean",
"null"
]
},
"found": {
"type": "boolean"
},
"fullName": {
"type": "string"
},
"lastPushAgeDays": {
"type": [
"number",
"null"
]
},
"licenseSpdx": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"openIssues": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"pushedAt": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"risk": {
"type": [
"string",
"null"
]
},
"sizeKb": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"stargazers": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"topics": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The live risk frame Hyperliquid publishes per perp: funding, open interest, mark and oracle price, premium and 24h notional volume. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-asset-context?coin=BTC.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid coin symbol as its meta lists it (BTC, ETH, HYPE, kPEPE) [required]",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "market_hl_asset_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"coin": {
"type": "string"
},
"dayBaseVlm": {
"type": "string"
},
"dayNtlVlm": {
"type": "string"
},
"found": {
"type": "boolean"
},
"funding": {
"type": "string"
},
"impactPxs": {
"items": {},
"type": "array"
},
"markPx": {
"type": "string"
},
"midPx": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"openInterest": {
"type": "string"
},
"oraclePx": {
"type": "string"
},
"premium": {
"type": "string"
},
"prevDayPx": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "candleSnapshot for one Hyperliquid perp: open, high, low, close, volume and order count per bucket, oldest first, bounded to the window each interval can carry. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-candles?coin=BTC&interval=1m&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid coin symbol as its meta lists it (BTC, ETH, HYPE, kPEPE) [required]",
"type": "string"
},
"interval": {
"description": "candle interval (default \"1m\")",
"type": "string"
},
"limit": {
"description": "candles (max 500) (default 48)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "market_hl_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"interval": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Every funding print Hyperliquid has for a perp coin since a look-back point: rate, premium component and the settlement timestamp. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-funding-history?coin=BTC&hours=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid coin symbol as its meta lists it (BTC, ETH, HYPE, kPEPE) [required]",
"type": "string"
},
"hours": {
"description": "look-back in whole hours (max 720) (default 72)",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "market_hl_funding_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"coin": {
"type": "string"
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"hours": {
"type": "integer"
},
"latestRate": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The venue's own mid for one or more Hyperliquid perp coins, straight from allMids — the reference price a funding or liquidation check starts from. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-mid-price?coins=BTC,ETH.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coins": {
"description": "comma list of up to 12 Hyperliquid coin symbols (default BTC,ETH,HYPE) (default [\"BTC\",\"ETH\",\"HYPE\"])",
"type": "string"
}
},
"type": "object"
},
"name": "market_hl_mid_price",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"matched": {
"type": "integer"
},
"mids": {
"additionalProperties": {},
"type": "object"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Hyperliquid's l2Book for one perp: the resting bid and ask levels with price, size and opaque-order count, plus the book time. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-order-book?coin=BTC.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"coin": {
"description": "Hyperliquid coin symbol as its meta lists it (BTC, ETH, HYPE, kPEPE) [required]",
"type": "string"
}
},
"required": [
"coin"
],
"type": "object"
},
"name": "market_hl_order_book",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asks": {
"items": {},
"type": "array"
},
"bestAsk": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bids": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"coin": {
"type": "string"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Per-coin contract rules from Hyperliquid's own meta: size decimals, maximum leverage and the margin table id, for the whole listed universe or filtered by substring. Costs $0.001 USDC per call. Byte-identical to GET /market/hl-perp-specs?contains=PEPE&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contains": {
"description": "case-insensitive substring filter on the coin name (default null)",
"type": "string"
},
"limit": {
"description": "coins to return (max 100) (default 25)",
"type": "string"
}
},
"type": "object"
},
"name": "market_hl_perp_specs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"universe": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "The most recently listed tokens on Jupiter's token API: mint, name, supply, market cap, liquidity, launch pool and the audit flags Jupiter attaches — a launch feed, not a recommendation. Costs $0.001 USDC per call. Byte-identical to GET /market/jup-new-tokens?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "tokens to return (max 30) (default 15)",
"type": "string"
}
},
"type": "object"
},
"name": "market_jup_new_tokens",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Current USD price, 24h change, liquidity, decimals and the block the quote came from for up to 20 Solana mints, in one call — with an explicit list of which mints returned nothing. Costs $0.001 USDC per call. Byte-identical to GET /market/jup-token-prices?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"mints": {
"description": "comma list of up to 20 Solana token mints [required]",
"type": "string"
}
},
"required": [
"mints"
],
"type": "object"
},
"name": "market_jup_token_prices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"notPriced": {
"items": {},
"type": "array"
},
"note": {
"type": [
"string",
"null"
]
},
"priced": {
"type": "integer"
},
"prices": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Solana tokens matching a name or symbol query, with market cap, FDV, liquidity, holder count, price-change and volume statistics and Jupiter's own audit flags. Costs $0.001 USDC per call. Byte-identical to GET /market/jup-token-search?query=bonk&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "tokens to return (max 20) (default 8)",
"type": "string"
},
"query": {
"description": "token name, symbol or mint prefix to search for [required]",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "market_jup_token_search",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"query": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Top of the Kraken book for one pair: resting bid and ask levels with size and price-count, plus the derived spread and mid. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-depth?pair=XBTUSD&count=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"count": {
"description": "levels per side (max 50) (default 10)",
"type": "string"
},
"pair": {
"description": "Kraken pair as the venue spells it: XBTUSD, ETHUSD, SOLUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_depth",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asks": {
"items": {},
"type": "array"
},
"bestAsk": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bids": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"spreadPct": {
"type": "number"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "OHLCV candles for one Kraken pair: open, high, low, close, volume and trade count per bucket, oldest first. Only the intervals the venue actually serves are offered. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-ohlc?pair=XBTUSD&interval=15&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"interval": {
"description": "candle width in minutes (360 is rejected by Kraken; 30 and 720 are unmeasured and therefore not offered) (default \"15\")",
"type": "string"
},
"limit": {
"description": "how many candles (max 720) (default 48)",
"type": "string"
},
"pair": {
"description": "Kraken pair as the venue spells it: XBTUSD, ETHUSD, SOLUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_ohlc",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"interval": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "How Kraken itself defines a pair: base and quote, decimal precision, order size limits, the public leverage ladder and the first two fee tiers. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-pair-spec?pair=XXBTZUSD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pair": {
"description": "Kraken pair key as stored by the venue (XXBTZUSD) [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_pair_spec",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"altname": {
"type": "string"
},
"base": {
"type": "string"
},
"baseClass": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"costDecimals": {
"type": "integer"
},
"costMin": {
"type": "string"
},
"found": {
"type": "boolean"
},
"leverageBuy": {
"items": {},
"type": "array"
},
"leverageSell": {
"items": {},
"type": "array"
},
"longPositionLimit": {
"type": "integer"
},
"lot": {
"type": "string"
},
"lotDecimals": {
"type": "integer"
},
"lotMultiplier": {
"type": "integer"
},
"marginCall": {
"type": "integer"
},
"marginStop": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"orderMin": {
"type": "string"
},
"pair": {
"type": "string"
},
"pairDecimals": {
"type": "integer"
},
"quote": {
"type": "string"
},
"quoteClass": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"shortPositionLimit": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"status": {
"type": "string"
},
"tickSize": {
"type": "string"
},
"ts": {
"type": "string"
},
"wsname": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Quoted spread samples for a Kraken pair with the mean spread in basis points — how expensive it is to cross that venue right now. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-spread?pair=XBTUSD&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "spread samples (max 500) (default 60)",
"type": "string"
},
"pair": {
"description": "Kraken pair as the venue spells it: XBTUSD, ETHUSD, SOLUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_spread",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"meanSpreadBps": {
"type": "number"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"samples": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Last trade, best bid and ask with size, 24h volume, VWAP and 24h high/low for one Kraken spot pair, straight from the venue's own tape. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-ticker?pair=XBTUSD.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pair": {
"description": "Kraken pair as the venue spells it: XBTUSD, ETHUSD, SOLUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ask": {
"type": "string"
},
"askSize": {
"type": "string"
},
"bid": {
"type": "string"
},
"bidSize": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"high24h": {
"type": "string"
},
"last": {
"type": "string"
},
"low24h": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trades24h": {
"type": "integer"
},
"ts": {
"type": "string"
},
"volume24h": {
"type": "string"
},
"vwap24h": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The last trades printed on a Kraken pair, each with price, size, side and exchange timestamp — tape activity, not a summary. Costs $0.001 USDC per call. Byte-identical to GET /market/kraken-trades?pair=XBTUSD&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "trades to return (max 200) (default 25)",
"type": "string"
},
"pair": {
"description": "Kraken pair as the venue spells it: XBTUSD, ETHUSD, SOLUSD [required]",
"type": "string"
}
},
"required": [
"pair"
],
"type": "object"
},
"name": "market_kraken_trades",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"pair": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trades": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "KuCoin's level-1 book for a symbol in one call: inside price, both sides with size, the book sequence and the venue timestamp. Costs $0.001 USDC per call. Byte-identical to GET /market/kucoin-best-quote?symbol=BTC-USDT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"symbol": {
"description": "KuCoin symbol, BASE-QUOTE in upper case (BTC-USDT, SOL-USDT) [required]",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "market_kucoin_best_quote",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bestAsk": {
"type": "string"
},
"bestAskSize": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bestBidSize": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"price": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"sequence": {
"type": "string"
},
"size": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"time": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "KuCoin candles with base and quote (transaction-value) volume per bucket, oldest first, across every type value the venue answered. Costs $0.001 USDC per call. Byte-identical to GET /market/kucoin-candles?symbol=BTC-USDT&type=1min&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "candles (max 1500; KuCoin answers at most 1500 per call) (default 48)",
"type": "string"
},
"symbol": {
"description": "KuCoin symbol, BASE-QUOTE in upper case (BTC-USDT, SOL-USDT) [required]",
"type": "string"
},
"type": {
"description": "KuCoin candle type (default \"1min\")",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "market_kucoin_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"ts": {
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "KuCoin's own 24h statistics for a symbol: last, best bid/ask with size, 24h high/low, change, base and quote volume, average price and the taker/maker fee rates it applies. Costs $0.001 USDC per call. Byte-identical to GET /market/kucoin-ticker?symbol=BTC-USDT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"symbol": {
"description": "KuCoin symbol, BASE-QUOTE in upper case (BTC-USDT, SOL-USDT) [required]",
"type": "string"
}
},
"required": [
"symbol"
],
"type": "object"
},
"name": "market_kucoin_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"averagePrice": {
"type": "string"
},
"buy": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"changePrice": {
"type": "string"
},
"changeRate": {
"type": "string"
},
"found": {
"type": "boolean"
},
"high": {
"type": "string"
},
"last": {
"type": "string"
},
"low": {
"type": "string"
},
"makerCoefficient": {
"type": "string"
},
"makerFeeRate": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"sell": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"takerCoefficient": {
"type": "string"
},
"takerFeeRate": {
"type": "string"
},
"time": {
"type": "integer"
},
"ts": {
"type": "string"
},
"vol": {
"type": "string"
},
"volValue": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Hourly or daily USD price points for one token reference (network:address) from DefiLlama's coin API, with the symbol and confidence it attaches to the series. Costs $0.001 USDC per call. Byte-identical to GET /market/llama-asset-price-history?ref=coingecko:bitcoin&period=1h&span=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "point spacing (default \"1h\")",
"type": "string"
},
"ref": {
"description": "asset reference as network:identifier [required]",
"type": "string"
},
"span": {
"description": "how many points (max 720) (default 48)",
"type": "string"
}
},
"required": [
"ref"
],
"type": "object"
},
"name": "market_llama_asset_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"confidence": {
"type": "number"
},
"count": {
"type": "integer"
},
"decimals": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"period": {
"type": "string"
},
"prices": {
"items": {},
"type": "array"
},
"reason": {
"type": [
"string",
"null"
]
},
"ref": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Daily total-value-locked history for one chain from DefiLlama's own series, downsampled to the window you ask for — the trend line, not a snapshot. Costs $0.001 USDC per call. Byte-identical to GET /market/llama-chain-tvl-history?chain=Ethereum&days=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain as DefiLlama names it (only measured names) (default \"Ethereum\")",
"type": "string"
},
"days": {
"description": "daily points to return (max 3650) (default 365)",
"type": "string"
}
},
"type": "object"
},
"name": "market_llama_chain_tvl_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"count": {
"type": "integer"
},
"days": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"latestTvlUsd": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Current USD price, symbol, decimals and confidence for up to 10 network:address references in one paid call — the cheapest way to mark a portfolio. Costs $0.001 USDC per call. Byte-identical to GET /market/llama-price-snapshot?refs=coingecko:bitcoin,base:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"refs": {
"description": "comma list of up to 10 network:identifier refs [required]",
"type": "string"
}
},
"required": [
"refs"
],
"type": "object"
},
"name": "market_llama_price_snapshot",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"notPriced": {
"items": {},
"type": "array"
},
"note": {
"type": [
"string",
"null"
]
},
"priced": {
"type": "integer"
},
"prices": {
"additionalProperties": {},
"type": "object"
},
"reason": {
"type": [
"string",
"null"
]
},
"requested": {
"type": "integer"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "One keyless read of the public npm registry for a package: does it ship an install-time script (the way malicious packages run code at install), is the released version deprecated, how old is the last publish, how many maintainers and dependencies, is there signed provenance, and what flags come out of those facts. Static metadata only: it does NOT execute the package, scan its source, or claim it is safe. Costs $0.001 USDC per call. Byte-identical to GET /market/npm-package-risk?name=left-pad.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "npm package name (optionally scoped) [required]",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "market_npm_package_risk",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"deprecated": {
"type": [
"string",
"null"
]
},
"depsCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"flags": {
"items": {},
"type": "array"
},
"found": {
"type": "boolean"
},
"hasInstallScript": {
"type": [
"boolean",
"null"
]
},
"installScripts": {
"items": {},
"type": "array"
},
"lastPublishAgeDays": {
"type": [
"number",
"null"
]
},
"latest": {
"type": [
"string",
"null"
]
},
"license": {
"type": [
"string",
"null"
]
},
"maintainerCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"provenance": {
"type": [
"boolean",
"null"
]
},
"publishedAt": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"risk": {
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"unpackedSize": {
"type": [
"string",
"null"
]
},
"versionCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
}
},
"type": "object"
}
},
{
"description": "One paid call that reads the package AND each of its direct dependencies (bounded, in published order) from the public npm registry, then rolls up what actually gets executed on install: which dependencies carry pre/postinstall scripts, which are deprecated, which ship without signed provenance, which are single-maintainer or unpublished-for-two-years. Returns the per-dependency rows, the counts, a verdict line, and an explicit list of what this cannot see. Static registry metadata only — it does not resolve a lockfile, walk the transitive tree beyond direct dependencies, download or execute any package, or compare against the name you meant to type. Costs $0.001 USDC per call. Byte-identical to GET /market/npm-tree-risk?name=left-pad.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "npm package name (optionally scoped) [required]",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "market_npm_tree_risk",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"cannotSee": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"dependencyCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"deps": {
"items": {},
"type": "array"
},
"directChecked": {
"type": "integer"
},
"failedSources": {
"items": {},
"type": "array"
},
"found": {
"type": "boolean"
},
"latest": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"risk": {
"type": [
"string",
"null"
]
},
"rollup": {
"additionalProperties": {},
"type": "object"
},
"rootDeprecated": {
"type": [
"string",
"null"
]
},
"rootFlags": {
"items": {},
"type": "array"
},
"rootHasInstallScript": {
"type": [
"boolean",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"sources": {
"items": {},
"type": "array"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"verdict": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Mark, base and quote volume per bucket for an OKX instrument, oldest first, across the bar widths the venue serves. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-candles?instId=BTC-USDT&bar=1m&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bar": {
"description": "OKX bar width (default \"1m\")",
"type": "string"
},
"instId": {
"description": "OKX instrument id, BASE-QUOTE (BTC-USDT, ETH-USDT-SWAP) [required]",
"type": "string"
},
"limit": {
"description": "candles (max 300) (default 48)",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_candles",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"bar": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"instId": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Price-level ladder from OKX for one instrument with per-level contract count, plus the derived top-of-book spread. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-depth?instId=BTC-USDT&levels=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instId": {
"description": "OKX instrument id, BASE-QUOTE (BTC-USDT, ETH-USDT-SWAP) [required]",
"type": "string"
},
"levels": {
"description": "levels per side (max 25) (default 10)",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_depth",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asks": {
"items": {},
"type": "array"
},
"bestAsk": {
"type": "string"
},
"bestBid": {
"type": "string"
},
"bids": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"instId": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Current and next funding rate for an OKX perpetual, with the settlement timestamps and the funding band the venue caps it at. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-funding-rate?instId=BTC-USDT-SWAP.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instId": {
"description": "OKX perpetual swap id [required]",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_funding_rate",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"formulaType": {
"type": "string"
},
"found": {
"type": "boolean"
},
"fundingRate": {
"type": "string"
},
"fundingRate8hPct": {
"type": "number"
},
"fundingTime": {
"type": "integer"
},
"impactValue": {
"type": "string"
},
"instId": {
"type": "string"
},
"instType": {
"type": "string"
},
"interestRate": {
"type": "string"
},
"maxFundingRate": {
"type": "string"
},
"method": {
"type": "string"
},
"minFundingRate": {
"type": "string"
},
"nextFundingTime": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"premium": {
"type": "string"
},
"prevFundingTime": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"settFundingRate": {
"type": "string"
},
"settState": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Contract rules as OKX defines them: tick and lot size, minimum size, price limits, whether it is a swap or option, and settlement date. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-instrument-spec?instId=BTC-USDT&instType=SPOT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instId": {
"description": "OKX instrument id, BASE-QUOTE (BTC-USDT, ETH-USDT-SWAP) [required]",
"type": "string"
},
"instType": {
"description": "which OKX instrument family to look in (default \"SPOT\")",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_instrument_spec",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"baseCcy": {
"type": "string"
},
"category": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"ctMult": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"ctType": {
"type": "string"
},
"ctVal": {
"type": [
"number",
"null"
]
},
"ctValCcy": {
"type": "string"
},
"expTimeMs": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
},
"instFamily": {
"type": "string"
},
"instId": {
"type": "string"
},
"instType": {
"type": "string"
},
"lever": {
"type": "string"
},
"listTimeMs": {
"type": "integer"
},
"lotSz": {
"type": "string"
},
"maxLmtAmt": {
"type": "string"
},
"maxLmtSz": {
"type": "string"
},
"maxMktSz": {
"type": "string"
},
"minSz": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"openType": {
"type": "string"
},
"optType": {
"type": "string"
},
"positionLimit": {
"type": "string"
},
"positionLimitPct": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"quoteCcy": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"ruleType": {
"type": "string"
},
"settleCcy": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"state": {
"type": "string"
},
"tickSz": {
"type": "string"
},
"tradeQuoteCcyList": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
},
"uly": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Last, bid, ask, 24h open/high/low and both base and quote volume for one OKX instrument. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-ticker?instId=BTC-USDT.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instId": {
"description": "OKX instrument id, BASE-QUOTE (BTC-USDT, ETH-USDT-SWAP) [required]",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_ticker",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"askPx": {
"type": "string"
},
"askSz": {
"type": "string"
},
"bidPx": {
"type": "string"
},
"bidSz": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"high24h": {
"type": "string"
},
"instId": {
"type": "string"
},
"instType": {
"type": "string"
},
"last": {
"type": "string"
},
"lastSz": {
"type": "string"
},
"low24h": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"open24h": {
"type": "string"
},
"quoteVolume24h": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"sodUtc0": {
"type": "string"
},
"sodUtc8": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
},
"venueTsMs": {
"type": "integer"
},
"volume24h": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Fill-by-fill tape from OKX with aggressor side, price, size and venue timestamp. Costs $0.001 USDC per call. Byte-identical to GET /market/okx-trades?instId=BTC-USDT&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"instId": {
"description": "OKX instrument id, BASE-QUOTE (BTC-USDT, ETH-USDT-SWAP) [required]",
"type": "string"
},
"limit": {
"description": "trades (max 100) (default 25)",
"type": "string"
}
},
"required": [
"instId"
],
"type": "object"
},
"name": "market_okx_trades",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"instId": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"trades": {
"items": {},
"type": "array"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Everything Polymarket's API records for one market id: the question and description, resolution source and resolver, outcomes and prices, the whole volume and liquidity series it reports, fees and the CLOB token ids. Costs $0.001 USDC per call. Byte-identical to GET /market/poly-market-detail?id=559681.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "Polymarket numeric market id [required]",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "market_poly_market_detail",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"acceptingOrders": {
"type": "boolean"
},
"active": {
"type": "boolean"
},
"bestAsk": {
"type": "number"
},
"bestBid": {
"type": [
"number",
"null"
]
},
"caveat": {
"type": [
"string",
"null"
]
},
"clobTokenIds": {
"items": {},
"type": "array"
},
"closed": {
"type": "boolean"
},
"conditionId": {
"type": "string"
},
"description": {
"type": "string"
},
"enableOrderBook": {
"type": "boolean"
},
"endDate": {
"type": "string"
},
"feeType": {
"type": "string"
},
"found": {
"type": "boolean"
},
"id": {
"type": "string"
},
"lastTradePrice": {
"type": "number"
},
"liquidityNum": {
"type": [
"number",
"null"
]
},
"makerBaseFee": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"oneDayPriceChange": {
"type": [
"number",
"null"
]
},
"orderMinSize": {
"type": "integer"
},
"outcomePrices": {
"items": {},
"type": "array"
},
"outcomes": {
"items": {},
"type": "array"
},
"question": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"resolutionSource": {
"type": "string"
},
"resolutionStatuses": {
"items": {},
"type": "array"
},
"resolvedBy": {
"type": "string"
},
"slug": {
"type": "string"
},
"source": {
"type": "string"
},
"spread": {
"type": "number"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"startDate": {
"type": "string"
},
"takerBaseFee": {
"type": "integer"
},
"ts": {
"type": "string"
},
"umaBond": {
"type": "integer"
},
"umaReward": {
"type": "integer"
},
"volume24hr": {
"type": [
"number",
"null"
]
},
"volumeNum": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Open prediction markets ranked by the venue's own 24h volume or liquidity: question, outcomes with prices, volume, liquidity, spread, best bid/ask and the end date. Costs $0.001 USDC per call. Byte-identical to GET /market/poly-markets?order=volume24hr&limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "markets to return (max 20) (default 10)",
"type": "string"
},
"order": {
"description": "which venue field to rank by (default \"volume24hr\")",
"type": "string"
}
},
"type": "object"
},
"name": "market_poly_markets",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"order": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The topic tags Polymarket itself puts on markets, with each tag's id and slug — the vocabulary to filter or classify a prediction-market feed with. Costs $0.001 USDC per call. Byte-identical to GET /market/poly-tags?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "tags to return (max 50) (default 20)",
"type": "string"
}
},
"type": "object"
},
"name": "market_poly_tags",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "What a Blockscout explorer knows about an address: native balance and USD rate, whether it is a verified contract, its name, proxy implementation, ENS name, holder/token flags and the token record when the address itself is a token. Costs $0.001 USDC per call. Byte-identical to GET /market/scout-address-profile?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "which Blockscout explorer to ask (default \"base\")",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "market_scout_address_profile",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"balanceUpdatedAtBlock": {
"type": "integer"
},
"balanceWei": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"creationStatus": {
"type": "string"
},
"creationTransactionHash": {
"type": [
"string",
"null"
]
},
"creatorAddress": {
"type": [
"string",
"null"
]
},
"ensDomainName": {
"type": [
"string",
"null"
]
},
"exchangeRateUsd": {
"type": "number"
},
"found": {
"type": "boolean"
},
"hasLogs": {
"type": "boolean"
},
"hasTokenTransfers": {
"type": "boolean"
},
"hasTokens": {
"type": "boolean"
},
"implementations": {
"items": {},
"type": "array"
},
"isContract": {
"type": "boolean"
},
"isScam": {
"type": "boolean"
},
"isVerified": {
"type": "boolean"
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"proxyType": {
"type": "string"
},
"publicTags": {
"items": {},
"type": "array"
},
"reason": {
"type": [
"string",
"null"
]
},
"reputation": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"token": {
"anyOf": [
{
"additionalProperties": {},
"type": "object"
},
{
"type": "null"
}
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "One explorer's view of its chain right now: addresses, blocks and transactions all-time and today, gas price tiers in gwei, average block time, market cap, coin price and network utilisation. Costs $0.001 USDC per call. Byte-identical to GET /market/scout-chain-stats?chain=base.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "which Blockscout explorer to ask (default \"base\")",
"type": "string"
}
},
"type": "object"
},
"name": "market_scout_chain_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"averageBlockTimeMs": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"coinPriceChangePct": {
"type": [
"number",
"null"
]
},
"coinPriceUsd": {
"type": "number"
},
"found": {
"type": "boolean"
},
"gasPricesGwei": {
"additionalProperties": {},
"type": "object"
},
"gasPricesUpdatedAt": {
"type": "string"
},
"gasUsedToday": {
"type": "string"
},
"marketCapUsd": {
"type": "number"
},
"networkUtilizationPct": {
"type": "number"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"totalAddresses": {
"type": "integer"
},
"totalBlocks": {
"type": "integer"
},
"totalTransactions": {
"type": "integer"
},
"transactionsToday": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The explorer's own record for one ERC-20/721 token: name, symbol, type, decimals, holder count, total supply, circulating market cap, 24h volume and the USD exchange rate it quotes. Costs $0.001 USDC per call. Byte-identical to GET /market/scout-token-profile?chain=base&address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"description": "target address, 0x + 40 hex [required]",
"type": "string"
},
"chain": {
"description": "which Blockscout explorer to ask (default \"base\")",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "market_scout_token_profile",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"address": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"circulatingMarketCap": {
"type": "number"
},
"decimals": {
"type": "integer"
},
"exchangeRateUsd": {
"type": "number"
},
"found": {
"type": "boolean"
},
"holders": {
"type": "integer"
},
"iconUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"reputation": {
"type": "string"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"symbol": {
"type": "string"
},
"totalSupply": {
"type": "string"
},
"ts": {
"type": "string"
},
"type": {
"type": "string"
},
"volume24h": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "One call, several reads assembled into a verdict: the deepest DEX pool (liquidity, 24h volume, buy AND sell counts, FDV, pool age), what the deployed bytecode can actually be asked to do (mint, pause, blacklist, fee changes, max-wallet caps, whether ownership was renounced), and whether the token is an upgradeable proxy. Returns reasons, a risk score, and an explicit list of what it did NOT check. Static on-chain and venue evidence only — never a simulated sell and never a certification of safety. Costs $0.001 USDC per call. Byte-identical to GET /market/token-verdict?chain=base&token=0xc5102fE9359FD9a28f877a67E36B0F050d81a3CC.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chain key (the bytecode read needs an EVM chain; base is the default) [required]",
"type": "string"
},
"token": {
"description": "token contract address to judge [required]",
"type": "string"
}
},
"required": [
"chain",
"token"
],
"type": "object"
},
"name": "market_token_verdict",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"buys24h": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"cannotSee": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"chain": {
"type": "string"
},
"code": {
"additionalProperties": {},
"type": "object"
},
"disclaimer": {
"type": "string"
},
"failedSources": {
"items": {},
"type": "array"
},
"fdvUsd": {
"type": "number"
},
"found": {
"type": "boolean"
},
"liquidityUsd": {
"type": "number"
},
"marketCapUsd": {
"type": "number"
},
"name": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"pairAddress": {
"type": [
"string",
"null"
]
},
"pool": {
"additionalProperties": {},
"type": "object"
},
"poolAgeDays": {
"type": [
"number",
"null"
]
},
"priceUsd": {
"type": [
"string",
"null"
]
},
"proxy": {
"type": "boolean"
},
"reason": {
"type": [
"string",
"null"
]
},
"reasons": {
"items": {},
"type": "array"
},
"riskLevel": {
"type": "string"
},
"riskScore": {
"type": "integer"
},
"sells24h": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"signals": {
"additionalProperties": {},
"type": "object"
},
"source": {
"type": "string"
},
"sources": {
"items": {},
"type": "array"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"supply": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"token": {
"type": "string"
},
"ts": {
"type": "string"
},
"verdict": {
"type": "string"
},
"volume24hUsd": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Demand history for a single host on this rail: thirty-day calls, unique payers, listed resources, last call timestamp, highest advertised price, and its rank among all listed hosts. The pre-purchase check an agent should run before paying an unknown endpoint. Costs $0.001 USDC per call. Byte-identical to GET /market/x402-host-demand?host=api.nansen.ai.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"host": {
"description": "hostname of the seller to check, without scheme (api.nansen.ai) [required]",
"type": "string"
}
},
"required": [
"host"
],
"type": "object"
},
"name": "market_x402_host_demand",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ageDays": {
"type": "number"
},
"asOf": {
"type": "string"
},
"calls30d": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"host": {
"type": "string"
},
"lastCalledAt": {
"type": "string"
},
"listed": {
"type": "boolean"
},
"maxPriceUsd": {
"type": "number"
},
"note": {
"type": [
"string",
"null"
]
},
"payers30d": {
"type": "integer"
},
"percentile": {
"type": "number"
},
"rankByCalls": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"resources": {
"type": "integer"
},
"snapshot": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"totalHosts": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Thirty-day demand on the x402 pay-per-call rail, measured from its own public discovery index: hosts listed, resources, total calls, summed unique payers, and the median/p90/p99 calls per host. The number that answers 'is anyone buying anything here' without trusting a marketing page. Costs $0.001 USDC per call. Byte-identical to GET /market/x402-overview?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_x402_overview",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ageDays": {
"type": "number"
},
"asOf": {
"type": "string"
},
"calls30d": {
"type": "integer"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"hosts": {
"type": "integer"
},
"hostsWithTraffic": {
"type": "integer"
},
"measuredFrom": {
"type": "string"
},
"medianCallsPerHost": {
"type": "integer"
},
"note": {
"type": [
"string",
"null"
]
},
"p90CallsPerHost": {
"type": "integer"
},
"p99CallsPerHost": {
"type": "integer"
},
"payerSlots30d": {
"type": "integer"
},
"reason": {
"type": [
"string",
"null"
]
},
"resources": {
"type": "integer"
},
"snapshot": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"top6HostSharePct": {
"type": "number"
},
"ts": {
"type": "string"
},
"windowDays": {
"type": "integer"
}
},
"type": "object"
}
},
{
"description": "Hosts grouped by count of unique paying wallets over thirty days, with the calls each group receives. Reads as the real distribution of the rail: how many sellers get one payer, how many get 2-60, and how much of all traffic the top group holds. Costs $0.001 USDC per call. Byte-identical to GET /market/x402-payer-bands?.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_x402_payer_bands",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ageDays": {
"type": "number"
},
"asOf": {
"type": "string"
},
"bands": {
"items": {},
"type": "array"
},
"caveat": {
"type": [
"string",
"null"
]
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"snapshot": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"top6HostSharePct": {
"type": "number"
},
"totalHosts": {
"type": "integer"
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "The hosts actually receiving calls on this rail, ranked by thirty-day call count, each with its unique-payer count, number of listed resources and the highest price it advertises. Use it to see who is earning and at what price point, instead of guessing from a directory. Costs $0.001 USDC per call. Byte-identical to GET /market/x402-top-sellers?limit=20.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "hosts to return, busiest first (max 50) (default 10)",
"type": "string"
}
},
"type": "object"
},
"name": "market_x402_top_sellers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ageDays": {
"type": "number"
},
"asOf": {
"type": "string"
},
"caveat": {
"type": [
"string",
"null"
]
},
"count": {
"type": "integer"
},
"found": {
"type": "boolean"
},
"note": {
"type": [
"string",
"null"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"rows": {
"items": {},
"type": "array"
},
"snapshot": {
"type": "boolean"
},
"source": {
"type": "string"
},
"stale": {
"type": [
"boolean",
"null"
]
},
"ts": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Search crypto tokens by name or symbol; returns the highest-liquidity matched pairs with price, liquidity, FDV and 24h volume across chains. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "token name or symbol, e.g. \"pepe\" or \"coinbase\"",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_tokens",
"outputSchema": null
},
{
"description": "Circulating USD-pegged supply with peg mechanism and chain count. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "stablecoin_supply",
"outputSchema": null
},
{
"description": "Market-cap table with price, market cap, 24h volume and 1h/24h/7d change. Public aggregator snapshot, not an oracle. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"vs": {
"description": "quote currency",
"enum": [
"usd",
"eur",
"gbp",
"jpy",
"btc",
"eth"
],
"type": "string"
}
},
"type": "object"
},
"name": "top_markets",
"outputSchema": null
},
{
"description": "Tokens currently bought into by projects for DEX exposure, enriched with price, liquidity and 24h volume. Boosts are paid promotions, not an endorsement. Costs $0.001 USDC per call via x402.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"chain": {
"description": "chainId filter, e.g. base or solana",
"maxLength": 32,
"type": "string"
},
"limit": {
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "trending_tokens",
"outputSchema": null
},
{
"description": "Free, no payment: proves this origin's x402 rail-intelligence routes are live by returning only the headline totals of our measured 30-day demand map (hosts, resources, calls, summed payers, median calls per host). WHICH hosts are earning, per-host calls/payers/rank and the per-token risk verdict stay paid — GET /market/x402-overview, /market/x402-top-sellers, /market/x402-host-demand, /market/x402-payer-bands, /market/token-verdict.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "x402_rail_heartbeat",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ageDays": {
"type": [
"number",
"null"
]
},
"asOf": {
"type": [
"string",
"null"
]
},
"calls30d": {
"type": "integer"
},
"demo": {
"type": "boolean"
},
"hosts": {
"type": "integer"
},
"medianCallsPerHost": {
"type": "integer"
},
"paid": {
"additionalProperties": {},
"type": "object"
},
"payerSlots30d": {
"type": "integer"
},
"resources": {
"type": "integer"
},
"snapshot": {
"type": "boolean"
},
"top6HostSharePct": {
"type": "number"
}
},
"required": [
"demo",
"snapshot",
"asOf",
"ageDays",
"hosts",
"resources",
"calls30d",
"payerSlots30d",
"medianCallsPerHost",
"top6HostSharePct",
"paid"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:ec4a04d2005190f155207b31eb3d4dc1d52842cba2a7951aedbc204b0f880868 | sha256sum