# ARYSPHERE x402 channel

> Paid HTTP endpoints for AI agents, settled per call over x402 v2 in USDC on Base (eip155:8453). No account and no API key: an unpaid GET answers 402 with the terms, and a retry with a signed PAYMENT-SIGNATURE header is served.

Every route below is a GET with query parameters. The price is per call. The 402 response's PAYMENT-REQUIRED header carries the exact payment requirements; any x402 v2 client (x402-fetch, x402-axios, Coinbase AgentKit) pays it.

## Paid routes

- [base_token_verdict_v3](https://api.arysphere.com/v1/ventures/x402_bazaar_token_verdict_v2/base_token_verdict_v3): $0.01 per call; query: token. Base ERC-20 verdict of a token contract address.  Returns: an AI-written token verdict on one token contract: grade (BASED/MID/COOKED/RADIOACTIVE, a stated rule over the contract's own state), a one-liner and a roast, and the facts read: code size, name, symbol, decimals, supply, owner(), proxy slots. It does not read holders, liquidity or price and makes no safety or legitimacy call.
- [base_contract_abi](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_contract_abi): $0.002 per call; query: address. Base contract ABI (ERC-20 / ERC-721 and others) from a contract address. Returns the ABI of a contract on Base from its address.
- [base_erc20_balanceof](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_erc20_balanceof): $0.003 per call; query: address, token. Base ERC-20 token balance of a holder address. ERC-20 balance read on Base: takes token (ERC-20 contract, 0x + 40 hex) and address (holder, 0x + 40 hex) and returns that holder's balanceOf as read from the token contract.
- [base_erc721_ownerof](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_erc721_ownerof): $0.003 per call; query: id, token. Base NFT (ERC-721) owner of a token id. NFT owner read on Base: takes token (ERC-721 contract, 0x + 40 hex) and id (decimal token id) and returns the address that ownerOf(id) reports on the contract.
- [base_eth_getbalance](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_eth_getbalance): $0.002 per call; query: address. Base on-chain read: the native balance of an address. Returns the native ETH balance of a Base address via eth_getBalance. Takes one query parameter: address (0x + 40 hex).
- [base_eth_getblockbynumber](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_eth_getblockbynumber): $0.003 per call; query: block. Base on-chain read: a block by number or 'latest'. Returns Base block information for query parameter block (block number or latest) via eth_getBlockByNumber.
- [base_eth_getlogs](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_eth_getlogs): $0.003 per call; query: address, blocks, topic0. Base on-chain read: a contract's event logs, filtered by topic and block range. Event logs on Base: takes address (contract, 0x + 40 hex), optional topic0 (event signature hash, 0x + 64 hex) and optional blocks (last N blocks, 1-100, default 10), and returns the matching eth_getLogs entries.
- [base_eth_gettransactionbyhash](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_eth_gettransactionbyhash): $0.003 per call; query: hash. Base on-chain read: a transaction by its hash. Base eth_getTransactionByHash. Takes hash (transaction hash, 0x + 64 hex) and returns that Base transaction as the node returns it: from, to, value, gas, gas price, input, nonce, block number and transaction index, or null if the node does not know the hash.
- [base_reads_bundle](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/base_reads_bundle): $0.008 per call; query: none. Base bundle: several reads in one paid call. Returns base_eth_getbalance and network_info_summary results in one paid call, keyed by part name. Returns: each named part service's own result, in one paid call, keyed by the part's name -- exactly what each part returns when bought alone; the call succeeds only when every part answers. It takes the union of the parts' query parameters.
- [chain_fees_digest](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/chain_fees_digest): $0.002 per call; query: none. Gnosis Chain network data in one call.
- [eth_chainid](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_chainid): $0.002 per call; query: none. Ethereum mainnet on-chain read: the chain id the node reports. Ethereum mainnet eth_chainId: takes no query parameters and returns the chain id the node reports.
- [eth_getblockbynumber](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_getblockbynumber): $0.003 per call; query: block. Ethereum mainnet on-chain read: a block by number or 'latest'. Ethereum mainnet eth_getBlockByNumber: takes `block` (a block number, or 'latest') and returns that block exactly as the node gives it.
- [eth_gettransactionbyhash](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/eth_gettransactionbyhash): $0.003 per call; query: hash. Ethereum mainnet on-chain read: a transaction by its hash. Ethereum mainnet eth_getTransactionByHash: takes `hash` (transaction hash, 0x + 64 hex) and returns the transaction exactly as the node gives it, or null if the node does not know it.
- [gnosis_eth_getbalance](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/gnosis_eth_getbalance): $0.003 per call; query: address. Gnosis Chain on-chain read: the native balance of an address. Native xDAI balance of one address on Gnosis Chain at the latest block: the raw eth_getBalance result in wei (hex). Takes exactly one query parameter, address (0x + 40 hex).
- [gnosis_eth_getlogs](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/gnosis_eth_getlogs): $0.003 per call; query: address, blocks, topic0. Gnosis Chain on-chain read: a contract's event logs, filtered by topic and block range. Returns raw event logs for one Gnosis contract via eth_getLogs. Takes address (0x+40 hex), optional topic0 (0x+64 hex), optional blocks (last N, default 10).
- [network_info_balance_bundle](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/network_info_balance_bundle): $0.005 per call; query: none. Base bundle: several reads in one paid call. Returns network_info_summary and base_eth_getbalance in one paid call: Base chain summary plus native balance for an address. Returns: each named part service's own result, in one paid call, keyed by the part's name -- exactly what each part returns when bought alone; the call succeeds only when every part answers. It takes the union of the parts' query parameters.
- [network_info_summary](https://api.arysphere.com/v1/ventures/x402_chain_reads_v1/network_info_summary): $0.002 per call; query: none. Base network data in one call.
- [eth_mainnet_contract_abi](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_contract_abi): $0.003 per call; query: address. Ethereum mainnet contract ABI (ERC-20 / ERC-721 and others) from a contract address. Ethereum mainnet contract ABI. Takes query parameter address (contract, 0x + 40 hex). Returns the contract's ABI as JSON when one is available for that address.
- [eth_mainnet_erc20_allowance](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_allowance): $0.002 per call; query: owner, spender, token. Ethereum mainnet ERC-20 allowance a holder granted a spender. Ethereum mainnet ERC-20 allowance. Takes query parameters token (ERC-20 contract, 0x + 40 hex), owner (0x + 40 hex) and spender (0x + 40 hex). Returns the raw allowance read from the contract.
- [eth_mainnet_erc20_balanceof](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_balanceof): $0.002 per call; query: address, token. Ethereum mainnet ERC-20 token balance of a holder address. Ethereum mainnet ERC-20 balanceOf. Takes query parameters token (ERC-20 contract, 0x + 40 hex) and address (holder, 0x + 40 hex). Returns the holder's raw token balance read from the contract.
- [eth_mainnet_erc20_totalsupply](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc20_totalsupply): $0.003 per call; query: token. Ethereum mainnet ERC-20 total supply of a token contract. Total supply of an ERC-20 token contract on Ethereum via totalSupply given token address.
- [eth_mainnet_erc721_ownerof](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_erc721_ownerof): $0.003 per call; query: id, token. Ethereum mainnet NFT (ERC-721) owner of a token id. Returns the owner address of an ERC-721 token on Ethereum mainnet. Takes token (contract address, 0x plus 40 hex) and id (decimal token id).
- [eth_mainnet_eth_blocknumber](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_blocknumber): $0.003 per call; query: none. Ethereum mainnet on-chain read: the latest block number. Returns the latest Ethereum mainnet block number via eth_blockNumber. Takes no parameters.
- [eth_mainnet_eth_get_block_by_number](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_get_block_by_number): $0.003 per call; query: block. Ethereum mainnet on-chain read: a block by number or 'latest'. Returns an Ethereum mainnet block by number or 'latest' via eth_getBlockByNumber. Takes block (a block number, or 'latest').
- [eth_mainnet_eth_getbalance](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getbalance): $0.003 per call; query: address. Ethereum mainnet on-chain read: the native balance of an address. Ethereum mainnet ETH balance for one address via eth_getBalance. Takes address (0x + 40 hex) and returns the hex balance in wei.
- [eth_mainnet_eth_getcode](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getcode): $0.003 per call; query: address. Ethereum mainnet on-chain read: the deployed bytecode at an address. Takes an address (0x + 40 hex) and returns the contract bytecode on Ethereum mainnet via eth_getCode.
- [eth_mainnet_eth_getlogs](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_getlogs): $0.003 per call; query: address, blocks, topic0. Ethereum mainnet on-chain read: a contract's event logs, filtered by topic and block range. Ethereum mainnet contract event logs via eth_getLogs. Query parameters: address (contract, 0x + 40 hex), topic0 (optional event signature hash, 0x + 64 hex), blocks (optional, last N blocks, 1-100, default 10).
- [eth_mainnet_eth_gettransactionbyhash](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_gettransactionbyhash): $0.003 per call; query: hash. Ethereum mainnet on-chain read: a transaction by its hash. Returns full Ethereum transaction details by hash via eth_getTransactionByHash on Ethereum mainnet.
- [eth_mainnet_eth_gettransactioncount](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_eth_gettransactioncount): $0.003 per call; query: address. Ethereum mainnet on-chain read: an address's transaction count (nonce). Returns the number of transactions sent from an Ethereum address (eth_getTransactionCount).
- [eth_mainnet_gasprice](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_gasprice): $0.003 per call; query: none. Ethereum mainnet on-chain read: the current gas price in wei. Returns the current Ethereum mainnet gas price in wei; takes no parameters.
- [eth_mainnet_getblockbynumber](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_getblockbynumber): $0.003 per call; query: block. Ethereum mainnet on-chain read: a block by number or 'latest'. Returns the Ethereum block header for a given block number or 'latest'.
- [eth_mainnet_logs_and_tx](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_logs_and_tx): $0.005 per call; query: none. Ethereum mainnet bundle: several reads in one paid call. Returns eth_getLogs and eth_getTransactionByHash results for the given Ethereum mainnet parameters in one paid call. Returns: each named part service's own result, in one paid call, keyed by the part's name -- exactly what each part returns when bought alone; the call succeeds only when every part answers. It takes the union of the parts' query parameters.
- [eth_mainnet_tx_receipt](https://api.arysphere.com/v1/ventures/x402_eth_reads_v1/eth_mainnet_tx_receipt): $0.002 per call; query: hash. Ethereum mainnet on-chain read: a transaction receipt (status, gas used, logs) by hash. Ethereum mainnet transaction receipt via eth_getTransactionReceipt. Takes query parameter hash (transaction hash, 0x + 64 hex). Returns the node's receipt: status, block, gas used, logs.

## Discovery

- [OpenAPI](https://api.arysphere.com/openapi.json): every paid route with its x-payment-info
- [x402 manifest](https://api.arysphere.com/.well-known/x402): the routes and their payment terms
- [Bazaar listing](https://api.arysphere.com/discovery): the x402 Bazaar's discovery document
- [MCP](https://api.arysphere.com/mcp): the same routes as tools. POST JSON-RPC. A call with no payment returns the terms; retry with _meta["x402/payment"].