Verified EVM, Aptos and finance tools for AI agents; gas for 14 chains. Pay per call (x402).
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Checks whether a string is a well-formed address for EVM (EIP-55 checksum), Solana, Aptos (AIP-40) or Bitcoin (base58check, bech32, bech32m). With family "auto" it lists every family the string could be, and never picks one. A valid format is not evidence an address is safe, owned, or the one you meant.
Tool list last changed Oct 23, 2026.
Checks whether a string is a well-formed address for EVM (EIP-55 checksum), Solana, Aptos (AIP-40) or Bitcoin (base58check, bech32, bech32m). With family "auto" it lists every family the string could be, and never picks one. A valid format is not evidence an address is safe, owned, or the one you meant.
| Argument | Type | Description |
|---|---|---|
| family* | string | |
| address* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address",
"family"
],
"properties": {
"family": {
"enum": [
"evm",
"solana",
"aptos",
"bitcoin",
"auto"
],
"type": "string"
},
"address": {
"type": "string"
}
},
"additionalProperties": false
}Validates an address for a chain and returns its canonical form. EVM: EIP-55 (a wrong checksum is refused, never corrected). Aptos: AIP-40 strict form. Says only what can be known offline; it never guesses what kind of account an address is.
| Argument | Type | Description |
|---|---|---|
| chain* | string | number | CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like "base" are refused. |
| address* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"address"
],
"properties": {
"chain": {
"type": [
"string",
"number"
],
"description": "CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like \"base\" are refused."
},
"address": {
"type": "string"
}
},
"additionalProperties": false
}Validates an address against the Aptos address standard (AIP-40) and returns its canonical form: special addresses (0x0-0xf) as short form, all others as 0x + 64 digits. Strict by default; mode=relaxed also accepts a missing 0x or a few dropped leading zeros, and says which spelling you used (a truncated-looking address is always refused). With lookup=true it checks the chain to say whether the address is an account, an object, or neither, at one ledger version.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| lookup | boolean | |
| address* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"mode": {
"enum": [
"strict",
"relaxed"
],
"type": "string"
},
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"lookup": {
"type": "boolean"
},
"address": {
"type": "string"
}
},
"additionalProperties": false
}Converts between a human decimal amount and integer base units, using the asset's decimals read LIVE from the chain (never assumed from a symbol). Refuses to round: more decimal places than the asset has is an error. An ambiguous symbol returns AMBIGUOUS_INPUT.
| Argument | Type | Description |
|---|---|---|
| asset* | string | |
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| amount* | string | |
| direction* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amount",
"direction",
"asset"
],
"properties": {
"asset": {
"type": "string"
},
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"amount": {
"type": "string"
},
"direction": {
"enum": [
"toBase",
"toHuman"
],
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Turns a symbol, registry id, fungible-asset address or coin type into one asset, with its on-chain symbol/name/decimals read live. Several different assets share the symbols USDC and USDT (Circle/Tether native vs LayerZero-bridged); those return AMBIGUOUS_INPUT with every candidate, its issuer and how to select it. Assets outside the registry are returned with verified:false, never silently trusted.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| query* | string | |
| caseSensitive | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"query": {
"type": "string"
},
"caseSensitive": {
"type": "boolean"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Balances of an address for APT and fungible assets, all read at ONE ledger version (stated, or the current one pinned). Amounts are exact integer strings plus decimal strings. Default assets: APT and every verified asset; pass `assets` (symbols, ids, addresses, coin types) to choose. An ambiguous symbol fails the whole call. An address with no account and all-zero balances is reported honestly, not as an empty account.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| assets | array | |
| address* | string | |
| ledgerVersion | any | read the chain exactly as of this ledger version (default: the current one, pinned for consistency) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"assets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1
},
"address": {
"type": "string"
},
"ledgerVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
],
"description": "read the chain exactly as of this ledger version (default: the current one, pinned for consistency)"
}
},
"additionalProperties": false
}[PAID $0.005 USDC per call via x402] Gas unit price tiers (deprioritized/regular/prioritized) plus the cost of common transactions in octas, APT and USD. Gas units are MEASURED by simulating real transfers now, not taken from a table. USD comes only from two independent exchanges that agree; otherwise USD is explicitly unavailable. Transaction types: apt_transfer, apt_transfer_new_account; for anything else use aptos_tx_simulate.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| txTypes | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"txTypes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] name -> address, or address -> primary name (give exactly one). A name resolves to its TARGET address, which can differ from its owner; a registered name with no target resolves to nothing (NOT_FOUND) and its owner is never substituted. An address's primary name is returned only if that name resolves forward to the same address, so a spoofed reverse record is never trusted.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| address | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"name": {
"type": "string"
},
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"address": {
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Explains what an entry-function payload would do, in plain English, with every argument type-checked against the module ABI and amounts shown using the asset's live decimals. Known patterns (transfers, batch transfers, key rotation, code publishing) carry a risk flag from a fixed table; no flag means 'not recognised', never 'safe'.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| function* | string | |
| arguments | array | |
| typeArguments | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"function"
],
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"function": {
"type": "string"
},
"arguments": {
"type": "array",
"items": {}
},
"typeArguments": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}[PAID $0.005 USDC per call via x402] Runs an UNSIGNED entry-function transaction through the node's own simulator (no key needed, nothing is submitted) and returns success or the abort decoded in plain English, exact gas and fee, balance changes, and events. Arguments are type-checked against the module ABI first. Balance changes count only the framework's Withdraw/Deposit events, so assets that re-emit them (like USDC) are never double-counted. A simulation runs against the node's current state and cannot be pinned to an older ledger version.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| sender* | string | |
| function* | string | |
| arguments | array | |
| gasUnitPrice | any | |
| maxGasAmount | any | |
| typeArguments | array | |
| sequenceNumber | any |
[PAID $0.001 USDC per call via x402] Committed, failed, pending or not found for a transaction hash, with the VM status explained in plain English (Move aborts decoded to module, error name, code and category; the raw status is always included). Fee is computed from the VM's own fee statement.
| Argument | Type | Description |
|---|---|---|
| hash* | string | |
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string"
},
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Calls a Move #[view] function read-only, after checking every type argument and argument against the module's ABI: u64/u128/u256 must be decimal strings, vector<u8> a 0x hex string, Option<T> written {"vec":[]} or {"vec":[value]}, addresses in AIP-40 form. A wrong argument is a specific error from us, never an opaque node error. Optionally reads at a stated ledger version.
| Argument | Type | Description |
|---|---|---|
| chain | string | Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet) |
| function* | string | |
| arguments | array | |
| ledgerVersion | any | read the chain exactly as of this ledger version (default: the current one, pinned for consistency) |
| typeArguments | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"function"
],
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"function": {
"type": "string"
},
"arguments": {
"type": "array",
"items": {}
},
"ledgerVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
],
"description": "read the chain exactly as of this ledger version (default: the current one, pinned for consistency)"
},
"typeArguments": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Counts business days between two dates, adds business days to a date, or tests whether a date is a business day. Weekends are configurable. NO holidays are assumed: pass the holidays you want observed. Dates are calendar dates (YYYY-MM-DD) with no time zone.
| Argument | Type | Description |
|---|---|---|
| op* | string | |
| to | string | |
| days | integer | |
| from* | string | |
| weekend | string | |
| holidays | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"op",
"from"
],
"properties": {
"op": {
"enum": [
"count",
"add",
"is_business_day"
],
"type": "string"
},
"to": {
"type": "string"
},
"days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"from": {
"type": "string"
},
"weekend": {
"enum": [
"sat_sun",
"fri_sat",
"sun_only",
"none"
],
"type": "string"
},
"holidays": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 400
}
},
"additionalProperties": false
}Describes a supported chain: CAIP-2 id, display name, native currency, block explorers, and exactly which operations it supports. Omit `chain` to list every supported chain.
| Argument | Type | Description |
|---|---|---|
| chain | string | number | CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like "base" are refused. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"chain": {
"type": [
"string",
"number"
],
"description": "CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like \"base\" are refused."
}
},
"additionalProperties": false
}Add, subtract, multiply, divide, raise to an integer power, compare, or take a percentage, on decimal STRINGS with exact arithmetic (no floating point). The result is rounded only to the scale and rule you choose, and the response says whether rounding changed the value. JSON numbers are refused because they lose precision. Division by zero is an error.
| Argument | Type | Description |
|---|---|---|
| a* | string | |
| b* | string | |
| op* | string | |
| scale | integer | |
| rounding | string | rounding rule; default half_up (ties away from zero). half_even is banker's rounding |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"op",
"a",
"b"
],
"properties": {
"a": {
"type": "string"
},
"b": {
"type": "string"
},
"op": {
"enum": [
"add",
"subtract",
"multiply",
"divide",
"power",
"compare",
"percent_of"
],
"type": "string"
},
"scale": {
"type": "integer",
"maximum": 36,
"minimum": 0
},
"rounding": {
"enum": [
"down",
"up",
"floor",
"ceil",
"half_up",
"half_even",
"half_down"
],
"type": "string",
"description": "rounding rule; default half_up (ties away from zero). half_even is banker's rounding"
}
},
"additionalProperties": false
}Reads an agent from the ERC-8004 identity registry on Base: its owner address and the registration URI it points to, at one stated block. The URI is reported, not fetched (fetching arbitrary URLs for you is not this tool's job). An id that was never minted is NOT_FOUND.
| Argument | Type | Description |
|---|---|---|
| block | string | |
| agentId* | string | ERC-8004 agent id (decimal string) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"agentId"
],
"properties": {
"block": {
"type": "string"
},
"agentId": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,30})$",
"description": "ERC-8004 agent id (decimal string)"
}
},
"additionalProperties": false
}Summarises the feedback posted about an agent in the ERC-8004 reputation registry on Base, at one block: number of distinct clients, number of feedback entries, the registry's own summary value, and each client's latest entry (value, tags, revoked). It is EVIDENCE, not a verdict: anyone can post feedback from any address, so many clients is not proof of many people, and tag text is free text written by the client (shown as untrusted).
| Argument | Type | Description |
|---|---|---|
| block | string | |
| agentId* | string | ERC-8004 agent id (decimal string) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"agentId"
],
"properties": {
"block": {
"type": "string"
},
"agentId": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,30})$",
"description": "ERC-8004 agent id (decimal string)"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] How much a spender may take from an owner for a token, at one block, in exact base units and human units, flagging 'unlimited' approvals.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| owner* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| token* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| spender* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"token",
"owner",
"spender"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"owner": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"token": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"spender": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Native and ERC-20 balances of an address, ALL read at one stated block (number and hash returned). Token decimals are read from the token contract, never assumed; an address with no code, or a contract that is not a standard ERC-20, is an error and is never reported as a zero balance. Amounts are exact strings.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| assets | array | "native" and/or token contract addresses; default ["native"] |
| address* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"address"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"assets": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "\"native\" and/or token contract addresses; default [\"native\"]"
},
"address": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Number, hash, timestamp, base fee (gwei), gas used/limit and transaction count of one block. Use block "finalized" for a block that can no longer reorganize.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Decodes transaction calldata against an ABI that YOU supply and returns the function, its signature and each argument. If the selector is not in your ABI it says so and lists the selectors it does have; it does not guess from a selector database. An ABI that does not belong to the target contract can decode to plausible nonsense.
| Argument | Type | Description |
|---|---|---|
| abi* | array | JSON ABI objects, or human-readable signatures such as "function transfer(address to, uint256 amount)" |
| data* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"abi",
"data"
],
"properties": {
"abi": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "string",
"maxLength": 1000
}
]
},
"maxItems": 500,
"minItems": 1,
"description": "JSON ABI objects, or human-readable signatures such as \"function transfer(address to, uint256 amount)\""
},
"data": {
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.003 USDC per call via x402] Says what is at an address using on-chain evidence: empty account, EIP-7702 delegated account, EIP-1167 minimal proxy, EIP-1967 proxy (with implementation and admin), Safe wallet (with owners and threshold), or other contract. Each classification lists the evidence. It is not a safety verdict.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| address* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"address"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"address": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Decodes one event log (its topics and data) against an ABI that YOU supply and returns the event name and arguments. If no event in your ABI matches topic0 it says so rather than guessing from a database of known events.
| Argument | Type | Description |
|---|---|---|
| abi* | array | JSON ABI objects, or human-readable signatures such as "function transfer(address to, uint256 amount)" |
| data* | string | |
| topics* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"abi",
"topics",
"data"
],
"properties": {
"abi": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "string",
"maxLength": 1000
}
]
},
"maxItems": 500,
"minItems": 1,
"description": "JSON ABI objects, or human-readable signatures such as \"function transfer(address to, uint256 amount)\""
},
"data": {
"type": "string"
},
"topics": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 1
}
},
"additionalProperties": false
}[PAID $0.003 USDC per call via x402] Logs emitted by one contract in a block range of at most 2000 blocks, optionally filtered by topics. Refuses (rather than truncates) when more than 1000 logs match, so an answer is always complete.
| Argument | Type | Description |
|---|---|---|
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| topics | array | |
| address* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| toBlock* | string | |
| fromBlock* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"address",
"fromBlock",
"toBlock"
],
"properties": {
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"topics": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"maxItems": 4
},
"address": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"toBlock": {
"type": "string"
},
"fromBlock": {
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] The transaction count of an address at one stated block. Pending-pool transactions are not counted, and the answer says so.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| address* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"address"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"address": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
}
},
"additionalProperties": false
}[PAID $0.005 USDC per call via x402] Every transfer of one ERC-20 token out of (or into) a wallet across a block range of up to 20,000 blocks, with exact amounts, per-counterparty totals, per-UTC-day totals, and an accounting CSV. Reads public chain data only. The range is queried in full 2000-block pieces and the report refuses (rather than truncates) when more than 2000 transfers match.
| Argument | Type | Description |
|---|---|---|
| chain* | string | |
| token* | string | |
| wallet* | string | |
| toBlock* | string | |
| direction | string | |
| fromBlock* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"wallet",
"token",
"fromBlock",
"toBlock"
],
"properties": {
"chain": {
"type": "string"
},
"token": {
"type": "string"
},
"wallet": {
"type": "string"
},
"toBlock": {
"type": "string"
},
"direction": {
"enum": [
"out",
"in"
],
"type": "string"
},
"fromBlock": {
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Name, symbol, decimals and total supply of an ERC-20 read from its contract at one block. Handles tokens whose name/symbol are bytes32. If decimals() is missing, it is an error: decimals are never assumed.
| Argument | Type | Description |
|---|---|---|
| block | string | "latest" (default), "safe", "finalized", or a decimal block number. Every value in the answer is read at this one block |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| token* | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"token"
],
"properties": {
"block": {
"type": "string",
"description": "\"latest\" (default), \"safe\", \"finalized\", or a decimal block number. Every value in the answer is read at this one block"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"token": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Status (success / reverted / pending), block, gas used and the exact fee in wei and native units for a transaction hash. 'Not found' is reported as such and is not proof the transaction never existed.
| Argument | Type | Description |
|---|---|---|
| hash* | string | |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"hash"
],
"properties": {
"hash": {
"type": "string"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Current fee tiers for a chain as decimal strings with explicit units. EVM: confidence levels (default 99/95/90/80/70) in gwei with base fee, priority fee and max fee. Aptos: deprioritized/regular/prioritized gas unit prices in octas per gas unit. Data older than its freshness budget is an error, never a stale answer.
| Argument | Type | Description |
|---|---|---|
| chain* | string | number | CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like "base" are refused. |
| confidenceLevels | array | EVM only |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain"
],
"properties": {
"chain": {
"type": [
"string",
"number"
],
"description": "CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like \"base\" are refused."
},
"confidenceLevels": {
"type": "array",
"items": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"maxItems": 12,
"minItems": 1,
"description": "EVM only"
}
},
"additionalProperties": false
}Current gas price estimates for an EVM chain in Blocknative-compatible format (gwei). Default chain is Ethereum (1). Supported chain IDs: 1, 8453, 42161, 10, 137, 56, 43114, 59144, 534352, 324, 100, 81457, 5000, 42220.
| Argument | Type | Description |
|---|---|---|
| chainId | integer | EVM chain ID, e.g. 1 (Ethereum), 8453 (Base). Default 1. |
| chainid | integer | Alias of chainId (the REST spelling). |
| confidenceLevels | array | Confidence levels to return. Default 99, 95, 90, 80, 70. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"chainId": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "EVM chain ID, e.g. 1 (Ethereum), 8453 (Base). Default 1."
},
"chainid": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Alias of chainId (the REST spelling)."
},
"confidenceLevels": {
"type": "array",
"items": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"maxItems": 12,
"description": "Confidence levels to return. Default 99, 95, 90, 80, 70."
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Exact simple or compound interest for a principal, an annual percentage rate and a term in years, compounded annually, semiannually, quarterly, monthly, weekly or daily. The number of periods must be whole; fractional periods are refused, not approximated. Also returns the effective annual rate.
| Argument | Type | Description |
|---|---|---|
| scale | integer | |
| years* | string | |
| rounding | string | rounding rule; default half_up (ties away from zero). half_even is banker's rounding |
| principal* | string | |
| compounding* | string | |
| ratePercent* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"principal",
"ratePercent",
"years",
"compounding"
],
"properties": {
"scale": {
"type": "integer",
"maximum": 18,
"minimum": 0
},
"years": {
"type": "string"
},
"rounding": {
"enum": [
"down",
"up",
"floor",
"ceil",
"half_up",
"half_even",
"half_down"
],
"type": "string",
"description": "rounding rule; default half_up (ties away from zero). half_even is banker's rounding"
},
"principal": {
"type": "string"
},
"compounding": {
"enum": [
"simple",
"annual",
"semiannual",
"quarterly",
"monthly",
"weekly",
"daily"
],
"type": "string"
},
"ratePercent": {
"type": "string"
}
},
"additionalProperties": false
}EVM chains with live gas data, with chain IDs.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}[PAID $0.001 USDC per call via x402] Monthly payment, total interest and total paid for a fixed-rate amortizing loan, in exact arithmetic. The payment is rounded once to the currency scale and the final payment absorbs the rounding so the balance ends at exactly zero.
| Argument | Type | Description |
|---|---|---|
| scale | integer | |
| rounding | string | rounding rule; default half_up (ties away from zero). half_even is banker's rounding |
| principal* | string | |
| termMonths* | integer | |
| annualRatePercent* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"principal",
"annualRatePercent",
"termMonths"
],
"properties": {
"scale": {
"type": "integer",
"maximum": 8,
"minimum": 0
},
"rounding": {
"enum": [
"down",
"up",
"floor",
"ceil",
"half_up",
"half_even",
"half_down"
],
"type": "string",
"description": "rounding rule; default half_up (ties away from zero). half_even is banker's rounding"
},
"principal": {
"type": "string"
},
"termMonths": {
"type": "integer",
"maximum": 600,
"minimum": 1
},
"annualRatePercent": {
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Rounds, adds, subtracts, multiplies, or splits an amount of an ISO 4217 currency, using that currency's real number of minor units (JPY 0, USD 2, KWD 3). A currency not in the list is refused, never assumed to have 2 decimals. split divides a total into equal parts or by ratios so the parts always add back to the total exactly.
| Argument | Type | Description |
|---|---|---|
| op* | string | |
| other | string | |
| parts | integer | |
| amount* | string | |
| factor | string | |
| ratios | array | |
| currency* | string | |
| rounding | string | rounding rule; default half_up (ties away from zero). half_even is banker's rounding |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"currency",
"op",
"amount"
],
"properties": {
"op": {
"enum": [
"round",
"add",
"subtract",
"multiply",
"split"
],
"type": "string"
},
"other": {
"type": "string"
},
"parts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"amount": {
"type": "string"
},
"factor": {
"type": "string"
},
"ratios": {
"type": "array",
"items": {
"type": "string"
}
},
"currency": {
"type": "string"
},
"rounding": {
"enum": [
"down",
"up",
"floor",
"ceil",
"half_up",
"half_even",
"half_down"
],
"type": "string",
"description": "rounding rule; default half_up (ties away from zero). half_even is banker's rounding"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Given a transaction hash, lists the ERC-20 transfers in its receipt and, if you give expectations (payee, asset, amount, payer), says whether a successful transaction contains a matching transfer. Use it to check an x402 or other USDC payment. A match proves tokens moved; it does not prove what the payment was for.
| Argument | Type | Description |
|---|---|---|
| hash* | string | |
| asset | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| payTo | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| payer | string | 0x + 40 hex digits (EIP-55 checksum enforced when mixed-case) |
| amount | string | base units |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"hash"
],
"properties": {
"hash": {
"type": "string"
},
"asset": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"payTo": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"payer": {
"type": "string",
"description": "0x + 40 hex digits (EIP-55 checksum enforced when mixed-case)"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})$",
"description": "base units"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] Deterministic, publicly recomputable random integers derived from a FINALIZED block hash and a salt. Refuses a block that is not yet final. Not secret and not for cases where the salt can be chosen after seeing the block.
| Argument | Type | Description |
|---|---|---|
| max* | integer | |
| salt* | string | |
| block* | string | |
| chain* | string | EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused. |
| count* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"block",
"salt",
"count",
"max"
],
"properties": {
"max": {
"type": "integer",
"maximum": 1000000,
"minimum": 2
},
"salt": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"block": {
"type": "string"
},
"chain": {
"type": "string",
"description": "EVM CAIP-2 chain id such as eip155:8453, or a bare chain id number as a string. Chain names are refused."
},
"count": {
"type": "integer",
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] From a quoted amount in base units (integer string) and a slippage tolerance in basis points, computes the minimum you should accept (min_out, rounded down) or the maximum you should pay (max_in, rounded up). Integer arithmetic only; the rounding direction is stated.
| Argument | Type | Description |
|---|---|---|
| amount* | string | |
| direction* | string | |
| slippageBps* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amount",
"slippageBps",
"direction"
],
"properties": {
"amount": {
"type": "string"
},
"direction": {
"enum": [
"min_out",
"max_in"
],
"type": "string"
},
"slippageBps": {
"type": "integer",
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] For a Uniswap-V2-style pool, computes the exact output of a swap (the router's integer formula), the total cost versus the spot price including the fee, and the part due to trade size alone, in basis points. Inputs are reserves and amounts in base units. Does not know any pool: you supply the reserves.
| Argument | Type | Description |
|---|---|---|
| feeBps | integer | |
| amountIn* | string | |
| reserveIn* | string | |
| reserveOut* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reserveIn",
"reserveOut",
"amountIn"
],
"properties": {
"feeBps": {
"type": "integer",
"maximum": 10000,
"minimum": 0
},
"amountIn": {
"type": "string"
},
"reserveIn": {
"type": "string"
},
"reserveOut": {
"type": "string"
}
},
"additionalProperties": false
}Converts an ISO 8601 instant, or a local time plus its IANA zone, to another IANA zone. A local time skipped by a daylight-saving jump is refused; one that occurs twice returns AMBIGUOUS_INPUT with both instants. Zone abbreviations such as EST are refused.
| Argument | Type | Description |
|---|---|---|
| time* | string | |
| toZone* | string | |
| fromZone | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"time",
"toZone"
],
"properties": {
"time": {
"type": "string"
},
"toZone": {
"type": "string"
},
"fromZone": {
"type": "string"
}
},
"additionalProperties": false
}Converts between a human decimal amount and integer base units without ever rounding: too many decimals is an error. Decimals are never assumed: pass `decimals`, or an `asset` whose decimals are read from the chain (EVM: "native" or an ERC-20 token address, whose decimals() is read live from the chain; Aptos: any asset, with live decimals; an ambiguous symbol such as USDC returns AMBIGUOUS_INPUT with every option).
| Argument | Type | Description |
|---|---|---|
| asset | string | |
| chain* | string | number | CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like "base" are refused. |
| amount* | string | |
| decimals | integer | |
| direction* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"amount",
"direction"
],
"properties": {
"asset": {
"type": "string"
},
"chain": {
"type": [
"string",
"number"
],
"description": "CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like \"base\" are refused."
},
"amount": {
"type": "string"
},
"decimals": {
"type": "integer",
"maximum": 77,
"minimum": 0
},
"direction": {
"enum": [
"toBase",
"toHuman"
],
"type": "string"
}
},
"additionalProperties": false
}[PAID $0.001 USDC per call via x402] Whether a transaction is committed, failed, pending or not found, with a plain-English explanation. 'Not found' is reported as such and is not proof the transaction never existed.
| Argument | Type | Description |
|---|---|---|
| hash* | string | |
| chain* | string | number | CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like "base" are refused. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"chain",
"hash"
],
"properties": {
"hash": {
"type": "string"
},
"chain": {
"type": [
"string",
"number"
],
"description": "CAIP-2 chain id such as eip155:8453 (Base) or aptos:1; a bare EVM chain id number also works. Chain names like \"base\" are refused."
}
},
"additionalProperties": false
}Converts length, mass, volume, time, data, energy, area, speed and temperature using exact definitions (an inch is exactly 0.0254 m). Ambiguous names (oz, gal, pt, KB) return AMBIGUOUS_INPUT with the choices instead of picking one. Reports whether the result is exact or rounded.
| Argument | Type | Description |
|---|---|---|
| to* | string | |
| from* | string | |
| scale | integer | |
| value* | string | |
| rounding | string | rounding rule; default half_up (ties away from zero). half_even is banker's rounding |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"value",
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"scale": {
"type": "integer",
"maximum": 30,
"minimum": 0
},
"value": {
"type": "string"
},
"rounding": {
"enum": [
"down",
"up",
"floor",
"ceil",
"half_up",
"half_even",
"half_down"
],
"type": "string",
"description": "rounding rule; default half_up (ties away from zero). half_even is banker's rounding"
}
},
"additionalProperties": false
}[PAID $0.002 USDC per call via x402] For sellers taking x402 or other stablecoin payments: give the network, the settlement transaction (EVM hash or Solana signature) and your payout address, and optionally the asset, minimum amount (base units) and payer. Reads the chain itself and answers verdict "paid", "not_paid" (failed, or no matching transfer to you) or "unknown" (not found yet), with every token transfer it saw. Networks: eip155:84532, eip155:8453, eip155:1, eip155:137, eip155:42161, eip155:10, eip155:43114, eip155:1329, eip155:130, eip155:146, eip155:480, eip155:5042, eip155:999, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1. A match proves tokens reached you; it does not prove what they were for.
| Argument | Type | Description |
|---|---|---|
| tx* | string | EVM transaction hash (0x + 64 hex) or Solana transaction signature (base58) |
| asset | string | token contract (EVM) or mint (Solana) you expect; omit to accept any token |
| payTo* | string | your payout address (EVM 0x... or Solana base58) |
| payer | string | the address you expect the payment from |
| amount | string | minimum amount in base units (USDC: 1 USD = 1000000) |
| network* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sender",
"function"
],
"properties": {
"chain": {
"type": "string",
"description": "Aptos CAIP-2 id: aptos:1 (mainnet, default) or aptos:2 (testnet)"
},
"sender": {
"type": "string"
},
"function": {
"type": "string"
},
"arguments": {
"type": "array",
"items": {}
},
"gasUnitPrice": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
]
},
"maxGasAmount": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
]
},
"typeArguments": {
"type": "array",
"items": {
"type": "string"
}
},
"sequenceNumber": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
]
}
},
"additionalProperties": false
}| CAIP-2 id, one of: eip155:84532, eip155:8453, eip155:1, eip155:137, eip155:42161, eip155:10, eip155:43114, eip155:1329, eip155:130, eip155:146, eip155:480, eip155:5042, eip155:999, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"network",
"tx",
"payTo"
],
"properties": {
"tx": {
"type": "string",
"description": "EVM transaction hash (0x + 64 hex) or Solana transaction signature (base58)"
},
"asset": {
"type": "string",
"description": "token contract (EVM) or mint (Solana) you expect; omit to accept any token"
},
"payTo": {
"type": "string",
"description": "your payout address (EVM 0x... or Solana base58)"
},
"payer": {
"type": "string",
"description": "the address you expect the payment from"
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]{0,77})$",
"description": "minimum amount in base units (USDC: 1 USD = 1000000)"
},
"network": {
"type": "string",
"description": "CAIP-2 id, one of: eip155:84532, eip155:8453, eip155:1, eip155:137, eip155:42161, eip155:10, eip155:43114, eip155:1329, eip155:130, eip155:146, eip155:480, eip155:5042, eip155:999, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1"
}
},
"additionalProperties": false
}