{"info":{"description":"Pay-per-call Ethereum mainnet RPC for AI agents. Every endpoint proxies a single live RPC call - wallet and token balances, blocks, transactions, receipts, event logs, ENS name resolution, contract introspection, and NFT metadata - returning fresh data from a live Ethereum node. No API keys, no accounts, no subscriptions; pay per request in USDC on Base via x402.","title":"OneSource - Pay-per-call Ethereum RPC for Agents","version":"1.0.0","x-guidance":"OneSource exposes a curated catalog of live Ethereum mainnet RPC calls, each priced per request in USDC on Base. Every /api/chain/* endpoint is a thin wrapper around a single eth_* RPC method (eth_getBalance, eth_call, eth_getLogs, eth_getTransactionReceipt, eth_getBlockByNumber, etc.) against a live node - there is no cached or indexed data here; every response is freshly fetched. Pay per call by including a signed Payment-Signature header using USDC on Base; see /openapi.json for the full operation schema and per-endpoint pricing."},"openapi":"3.1.0","paths":{"/api/chain/allowance":{"get":{"description":"Returns how much of an ERC20 token a spender is approved to transfer from an owner via eth_call on allowance(owner, spender). Use before calling transferFrom, or to audit outstanding approvals for security review.","operationId":"chainAllowance","parameters":[{"description":"ERC20 contract address","in":"query","name":"token","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Token owner address","in":"query","name":"owner","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Approved spender address","in":"query","name":"spender","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"ERC20 allowance via allowance (eth_call) - how much a spender is approved to move from an owner's wallet","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum","owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","spender":"0x6b175474e89094c44da98b954eedeac495271d0f","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"method":"GET","queryParams":{"network":"ethereum","owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","spender":"0x6b175474e89094c44da98b954eedeac495271d0f","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"type":"http"},"output":{"example":{"data":{"allowance":"0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff","decimals":6,"owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","spender":"0x6b175474e89094c44da98b954eedeac495271d0f","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/allowance","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"owner":{"description":"Token owner address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"spender":{"description":"Approved spender address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["token","owner","spender"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"owner":{"description":"Token owner address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"spender":{"description":"Approved spender address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["token","owner","spender"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ERC20 allowance","approval","spender","transferFrom","token approval","infinite approval","revoke approval"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Verify a DEX router has enough allowance before swapping","Audit outstanding ERC20 approvals for security review","Check whether a wallet has given infinite approval to a contract","Confirm an approval transaction landed before calling transferFrom"]}},"/api/chain/block-number":{"get":{"description":"Returns the latest mined Ethereum block height via eth_blockNumber against a live node. No caching - every call queries the upstream RPC fresh. Use this to sync an agent to the chain tip, to detect progress or stalls, or as a cheap liveness ping before issuing more expensive RPC calls.","operationId":"chainBlockNumber","parameters":[{"description":"Blockchain network (currently only \"ethereum\" mainnet)","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Latest Ethereum block height - current chain tip via eth_blockNumber","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"block_number":"0x133da1e","network":"ethereum"},"error":null,"meta":{"cost_usdc":"0.001","endpoint":"/api/chain/block-number","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network (currently only \"ethereum\" mainnet)","enum":["ethereum"],"type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network (currently only \"ethereum\" mainnet)","enum":["ethereum"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["block number","chain tip","head block","latest block","block height","ethereum","eth_blockNumber","sync"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.001","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check the current Ethereum block height before querying logs or balances","Synchronize an agent to the chain tip before issuing queries","Detect chain progress or a stalled node","Use as a cheap liveness ping before paid RPC calls"]}},"/api/chain/block/{number}":{"get":{"description":"Returns the block header plus its transaction hashes for a given block number, tag (latest, pending, safe, finalized), or hex block number via eth_getBlockByNumber. Live from the upstream RPC node.","operationId":"chainBlock","parameters":[{"description":"Block number (hex or decimal)","in":"path","name":"number","required":true,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Fetch an Ethereum block header and transaction hashes by number, tag, or hex via eth_getBlockByNumber","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum","number":"latest"},"method":"GET","queryParams":{"network":"ethereum","number":"latest"},"type":"http"},"output":{"example":{"data":{"gas_limit":"0x1c9c380","gas_used":"0xe4e1c0","hash":"0x3f5f8b0a8e9b7c6d4f2a1b5e8c9d7a3f6e4b9d1c5a8f2e7b4d6c3a9e1f0b8d5c","number":"0x133da1e","parent_hash":"0x3f5f8b0a8e9b7c6d4f2a1b5e8c9d7a3f6e4b9d1c5a8f2e7b4d6c3a9e1f0b8d5b","timestamp":"0x6567c8e0"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/block/{number}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"number":{"description":"Block number (hex or decimal)","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},"required":["number"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"number":{"description":"Block number (hex or decimal)","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},"required":["number"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["block","block header","transactions","timestamp","gas used","parent hash","eth_getBlockByNumber"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Look up a specific Ethereum block by number","Read the block timestamp for a given height","Enumerate transaction hashes in a block","Fetch parent hashes for reorg detection"]}},"/api/chain/call":{"post":{"description":"Simulates a contract read via eth_call - returns the raw ABI-encoded result without submitting a transaction. Pass 'to' (contract address) and 'data' (ABI-encoded calldata); optional 'from', 'value', and 'block' override the caller, msg.value, and block tag.","operationId":"chainCall","parameters":[{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"ABI-encoded call data (hex)","type":"string"},"from":{"description":"Caller address (optional)","type":"string"},"to":{"description":"Target contract address","type":"string"},"value":{"description":"ETH value in wei (hex, optional)","type":"string"}},"required":["to","data"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Simulate a read-only Ethereum contract call via eth_call - no transaction sent","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"data":"0x0","to":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"bodyType":"json","method":"POST","type":"http"},"output":{"example":{"data":{"result":"0x000000000000000000000000000000000000000000000000000000000000002a"},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/call","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"data":{"description":"ABI-encoded call data (hex)","type":"string"},"from":{"description":"Caller address (optional)","type":"string"},"to":{"description":"Target contract address","type":"string"},"value":{"description":"ETH value in wei (hex, optional)","type":"string"}},"required":["to","data"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["eth_call","contract read","simulate call","view function","ABI call","read-only","dry run"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Read the return value of a view function on any Ethereum contract","Simulate a contract interaction before sending a real transaction","Execute an arbitrary ABI-encoded call to inspect contract behaviour","Read on-chain state not exposed through a convenience endpoint"]}},"/api/chain/chain-id":{"get":{"description":"Returns the EIP-155 chain ID via eth_chainId, queried live from the upstream RPC node. Verify a backend is serving the expected chain before signing an EIP-155 transaction.","operationId":"chainChainId","parameters":[{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Ethereum chain ID (EIP-155) via eth_chainId - confirm which chain a network is on","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"chain_id":"0x1","network":"ethereum"},"error":null,"meta":{"cost_usdc":"0.001","endpoint":"/api/chain/chain-id","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["chain id","network id","EIP-155","chain identifier","mainnet","ethereum","eth_chainId"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.001","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Verify the backend is actually serving Ethereum mainnet","Validate chain context before signing an EIP-155 transaction","Detect accidental testnet configuration"]}},"/api/chain/code/{address}":{"get":{"description":"Returns the deployed bytecode at an address via eth_getCode. Empty bytecode means the address is an EOA (wallet); non-empty means it's a contract. Response includes a bytecode_size field for quick classification.","operationId":"chainCode","parameters":[{"description":"Contract or wallet address","in":"path","name":"address","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Check if an Ethereum address is a contract via eth_getCode - returns deployed bytecode","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"method":"GET","queryParams":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","bytecode_size":10234,"code":"0x6080604052600436106101...","is_contract":true},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/code/{address}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Contract or wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Contract or wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["bytecode","contract detection","EOA vs contract","deployed code","is contract","eth_getCode"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Determine whether an address is a wallet (EOA) or a contract","Fetch a contract's deployed bytecode for analysis","Compare bytecode across deployments to detect proxy upgrades","Verify a contract is deployed at an address before sending funds"]}},"/api/chain/contract/{address}":{"get":{"description":"Introspects a contract via eth_call - probes name(), symbol(), decimals(), and supportsInterface() to report what token standards (ERC20, ERC721, ERC1155) the contract claims to implement. Ideal for classifying an unknown contract.","operationId":"chainContract","parameters":[{"description":"Contract address","in":"path","name":"address","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Contract introspection via eth_call - name, symbol, decimals, and ERC20/721/1155 interface support","tags":["blockchain","ethereum","onesource","rpc","live-data","smart-contract"],"x-bazaar":{"info":{"input":{"body":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"method":"GET","queryParams":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","decimals":6,"interfaces":["ERC20"],"name":"Tether USD","symbol":"USDT"},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/contract/{address}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["contract info","name symbol decimals","supportsInterface","ERC20","ERC721","ERC1155","token standard","contract classification"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Classify an unknown contract as ERC20, ERC721, or ERC1155","Fetch a token's symbol and decimals before formatting a balance","Probe a contract for which interfaces it declares support for","Build a token directory entry from a contract address"]}},"/api/chain/ens/{input}":{"get":{"description":"Resolves a *.eth ENS name to its address (forward lookup) or an address to its primary ENS name (reverse lookup) via eth_call on the ENS Registry and Resolver contracts. Auto-detects direction from the input format.","operationId":"chainEns","parameters":[{"description":"ENS name (e.g. vitalik.eth) or address (0x...)","in":"path","name":"input","required":true,"schema":{"oneOf":[{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},{"pattern":".+\\.eth$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"ENS resolve - turn a .eth name into an address, or an address into its primary .eth name, via eth_call on OneSource live Ethereum RPC","tags":["blockchain","ethereum","onesource","rpc","live-data","ens","identity"],"x-bazaar":{"info":{"input":{"body":{"input":"vitalik.eth","network":"ethereum"},"method":"GET","queryParams":{"input":"vitalik.eth","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","input":"vitalik.eth","mode":"forward"},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/ens/{input}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"input":{"description":"ENS name (e.g. vitalik.eth) or address (0x...)","oneOf":[{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},{"pattern":".+\\.eth$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["input"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"input":{"description":"ENS name (e.g. vitalik.eth) or address (0x...)","oneOf":[{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},{"pattern":".+\\.eth$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["input"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ENS","Ethereum Name Service",".eth","ENS resolve","reverse lookup","forward lookup","ENS address","vitalik.eth","primary name"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Resolve vitalik.eth (or any .eth name) to an Ethereum address","Look up the primary ENS name for an address","Display human-readable names instead of hex addresses in a UI","Verify whether a wallet has set a primary ENS name"]}},"/api/chain/erc1155-balance":{"get":{"description":"Fetches an account's balance of a specific ERC1155 token_id by eth_call-ing balanceOf(address, uint256). Supports any ERC1155 contract - gaming items, editions, semi-fungible assets.","operationId":"chainErc1155Balance","parameters":[{"description":"Wallet address","in":"query","name":"account","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"ERC1155 contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Token ID","in":"query","name":"token_id","required":true,"schema":{"pattern":"^[0-9]+$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"ERC1155 token balance via balanceOf (eth_call) - how many copies of a token_id a wallet holds","tags":["blockchain","ethereum","onesource","rpc","live-data","erc1155","token"],"x-bazaar":{"info":{"input":{"body":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum","token_id":"1"},"method":"GET","queryParams":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum","token_id":"1"},"type":"http"},"output":{"example":{"data":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balance":"42","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","token_id":"1"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/erc1155-balance","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"account":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"contract":{"description":"ERC1155 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["account","contract","token_id"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"account":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"contract":{"description":"ERC1155 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["account","contract","token_id"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ERC1155 balance","multi-token","semi-fungible","gaming tokens","editions","balanceOf"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check how many copies of an ERC1155 item a wallet owns","Read a gaming or edition-based token balance","Verify ownership of a specific ERC1155 token_id","Snapshot an ERC1155 inventory for a wallet"]}},"/api/chain/erc20-balance":{"get":{"description":"Fetches an account's balance of a specific ERC20 token by eth_call-ing balanceOf(address). Returns the raw balance plus the token's decimals and symbol for convenience. Works for any ERC20 contract.","operationId":"chainErc20Balance","parameters":[{"description":"Wallet address","in":"query","name":"account","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"ERC20 contract address","in":"query","name":"token","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"ERC20 token balance for any Ethereum wallet - USDC, USDT, DAI, or any token - via balanceOf (eth_call) on OneSource live Ethereum RPC","tags":["blockchain","ethereum","onesource","rpc","live-data","erc20","token"],"x-bazaar":{"info":{"input":{"body":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"method":"GET","queryParams":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"type":"http"},"output":{"example":{"data":{"account":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","balance":"1234567890","decimals":6,"symbol":"USDT","token":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/erc20-balance","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"account":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["account","token"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"account":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["account","token"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ERC20 balance","token balance","balanceOf","USDC balance","USDT balance","DAI balance","token holdings","stablecoin balance"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check how much USDC, USDT, or any ERC20 token a wallet holds","Read a single token balance for one wallet","Snapshot a specific token position before a swap","Detect when a wallet's token balance changes"]}},"/api/chain/erc20-transfers":{"get":{"description":"Specialized eth_getLogs query that filters on the ERC20 Transfer(address,address,uint256) topic and optionally narrows to a token contract or a specific wallet (sender or recipient). Decodes the indexed from/to and raw value.","operationId":"chainErc20Transfers","parameters":[{"description":"ERC20 contract address","in":"query","name":"token","required":false,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Wallet address filter","in":"query","name":"wallet","required":false,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Start block","in":"query","name":"from_block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"End block","in":"query","name":"to_block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"ERC20 Transfer logs via eth_getLogs - decoded sender, recipient, and amount for a token or wallet","tags":["blockchain","ethereum","onesource","rpc","live-data","erc20","token"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"count":1,"transfers":[{"block_number":"0x133da1e","from":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","to":"0x6b175474e89094c44da98b954eedeac495271d0f","token":"0xdac17f958d2ee523a2206206994597c13d831ec7","tx_hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","value":"1000000"}]},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/erc20-transfers","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"from_block":{"description":"Start block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"to_block":{"description":"End block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"wallet":{"description":"Wallet address filter","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"from_block":{"description":"Start block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"to_block":{"description":"End block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"token":{"description":"ERC20 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"wallet":{"description":"Wallet address filter","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ERC20 transfers","Transfer event","token transfer history","token flow","sender recipient","wallet transfers","eth_getLogs"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Reconstruct a wallet's ERC20 transfer history","Track inflows and outflows of a specific ERC20 token","Monitor a token contract for large transfers","Build a token activity feed for a wallet or contract"]}},"/api/chain/erc721-tokens":{"get":{"description":"Lists every ERC721 token_id held by an owner by combining balanceOf(owner) with tokenOfOwnerByIndex(owner, i) across a batched set of eth_call requests. Requires the contract to implement the ERC721Enumerable extension.","operationId":"chainErc721Tokens","parameters":[{"description":"ERC721 contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Owner address","in":"query","name":"owner","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Max tokens to return (default 50)","in":"query","name":"max","required":false,"schema":{"maximum":1000,"minimum":1,"type":"integer"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"List every ERC721 NFT token_id a wallet owns in a collection via tokenOfOwnerByIndex (eth_call)","tags":["blockchain","ethereum","onesource","rpc","live-data","ens","identity"],"x-bazaar":{"info":{"input":{"body":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"method":"GET","queryParams":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"type":"http"},"output":{"example":{"data":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","count":3,"owner":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","tokens":["1","42","100"]},"error":null,"meta":{"cost_usdc":"0.008","endpoint":"/api/chain/erc721-tokens","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"contract":{"description":"ERC721 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"max":{"description":"Max tokens to return (default 50)","maximum":1000,"minimum":1,"type":"integer"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"owner":{"description":"Owner address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["contract","owner"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"ERC721 contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"max":{"description":"Max tokens to return (default 50)","maximum":1000,"minimum":1,"type":"integer"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"owner":{"description":"Owner address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},"required":["contract","owner"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["ERC721 tokens","NFT enumeration","tokenOfOwnerByIndex","owned NFTs","NFT holdings","ERC721Enumerable"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.008","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["List the NFT token_ids a wallet holds in a specific collection","Check how many NFTs from one collection a wallet owns","Enumerate a whale's NFT holdings for display","Verify ownership of a range of NFTs before building a gallery"]}},"/api/chain/estimate-gas":{"post":{"description":"Estimates the gas a transaction would consume via eth_estimateGas. Accepts the same 'to', 'data', 'from', 'value' fields as /call. A failing estimate usually means the transaction would revert - use this to pre-flight a complex interaction before paying gas.","operationId":"chainEstimateGas","parameters":[{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"ABI-encoded call data (hex, optional)","type":"string"},"from":{"description":"Sender address (optional)","type":"string"},"to":{"description":"Target address","type":"string"},"value":{"description":"ETH value in wei (hex, optional)","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Estimate the gas a transaction will consume via eth_estimateGas before signing it","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"data":"0x0","to":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"bodyType":"json","method":"POST","type":"http"},"output":{"example":{"data":{"gas_estimate":"0x5208"},"error":null,"meta":{"cost_usdc":"0.004","endpoint":"/api/chain/estimate-gas","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"data":{"description":"ABI-encoded call data (hex, optional)","type":"string"},"from":{"description":"Sender address (optional)","type":"string"},"to":{"description":"Target address","type":"string"},"value":{"description":"ETH value in wei (hex, optional)","type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["gas estimate","gas limit","pre-flight","dry-run","revert check","eth_estimateGas"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.004","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Determine the gas limit for a transaction before broadcasting it","Check whether a transaction will revert by seeing if gas estimation fails","Compare expected gas cost across multiple contract strategies","Pre-flight a complex transaction before paying gas"]}},"/api/chain/events":{"get":{"description":"Queries contract event logs via eth_getLogs with optional filters on contract address, topic0 (event signature hash), and block range. Returns the raw logs - address, topics, data, block_number, tx_hash.","operationId":"chainEvents","parameters":[{"description":"Contract address filter","in":"query","name":"contract","required":false,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Topic0 filter (event signature hash)","in":"query","name":"topic","required":false,"schema":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"}},{"description":"Start block","in":"query","name":"from_block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"End block","in":"query","name":"to_block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Query Ethereum contract event logs via eth_getLogs - filter by contract, topic, and block range","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"count":1,"logs":[{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","block_number":"0x133da1e","data":"0x0000000000000000000000000000000000000000000000000000000000000001","topics":["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"],"tx_hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f"}]},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/events","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"contract":{"description":"Contract address filter","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"from_block":{"description":"Start block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"to_block":{"description":"End block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"topic":{"description":"Topic0 filter (event signature hash)","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"Contract address filter","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"from_block":{"description":"Start block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"to_block":{"description":"End block","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"topic":{"description":"Topic0 filter (event signature hash)","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["event logs","contract events","topic filter","log query","emitted events","indexed event","eth_getLogs"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Fetch all events emitted by a specific contract in a block range","Filter event logs by topic0 (event signature hash)","Track a contract's activity by polling its event stream","Reconstruct protocol state by replaying emitted events"]}},"/api/chain/live-balance":{"get":{"description":"Fetches the wallet's native ETH balance (eth_getBalance) and, when you pass a comma-separated list of ERC20 contract addresses in the optional 'tokens' param, batches a balanceOf eth_call per token alongside symbol() and decimals(). Returns a single snapshot of ETH plus any requested token balances. Live from the upstream RPC node.","operationId":"chainLiveBalance","parameters":[{"description":"Wallet address","in":"query","name":"address","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Comma-separated ERC20 contract addresses","in":"query","name":"tokens","required":false,"schema":{"type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Live wallet balance - native ETH plus any ERC20 tokens in one call via eth_getBalance and balanceOf on OneSource Ethereum RPC","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum"},"method":"GET","queryParams":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","eth":"0xde0b6b3a7640000","tokens":[{"balance":"1234567890","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","decimals":6,"symbol":"USDT"}]},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/live-balance","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"tokens":{"description":"Comma-separated ERC20 contract addresses","type":"string"}},"required":["address"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"tokens":{"description":"Comma-separated ERC20 contract addresses","type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["wallet balance","ETH balance","ERC20 balance","portfolio snapshot","native balance","multi-token","eth_getBalance","balanceOf"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check how much ETH and tokens a wallet currently holds","Get live ETH + USDC + USDT balances for any Ethereum address in one call","Snapshot a wallet's holdings before a swap, transfer, or gas estimation","Monitor a whale or smart-money address for real-time balance changes"]}},"/api/chain/network-info":{"get":{"description":"Batches eth_chainId, eth_blockNumber, and eth_gasPrice into a single round-trip to the upstream RPC node. Use this instead of three separate calls when bootstrapping an agent, probing liveness, or pre-flighting a transaction.","operationId":"chainNetworkInfo","parameters":[{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Ethereum network info - chain ID, block height, and gas price in one batched RPC call (eth_chainId + eth_blockNumber + eth_gasPrice)","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"block_number":"0x133da1e","chain_id":"0x1","gas_price":"0x4a817c800","network":"ethereum"},"error":null,"meta":{"cost_usdc":"0.001","endpoint":"/api/chain/network-info","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["network info","gas price","chain id","block height","bootstrap","eth_chainId","eth_gasPrice","eth_blockNumber"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.001","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Bootstrap an agent with one RPC round-trip instead of three","Probe network liveness, sync state, and fee level in a single call","Pre-flight check before submitting a signed transaction elsewhere"]}},"/api/chain/nft-metadata":{"get":{"description":"Calls tokenURI(tokenId) (ERC721) or uri(tokenId) (ERC1155) via eth_call, resolves ipfs:// URIs through a gateway, and returns the resolved metadata JSON alongside the raw URI. Works for most compliant NFT contracts.","operationId":"chainNftMetadata","parameters":[{"description":"NFT contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Token ID","in":"query","name":"token_id","required":true,"schema":{"pattern":"^[0-9]+$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"NFT metadata, traits, and image URI for any ERC721 or ERC1155 token - fetched via eth_call with IPFS resolution (OneSource live Ethereum RPC)","tags":["blockchain","ethereum","onesource","rpc","live-data","nft"],"x-bazaar":{"info":{"input":{"body":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","token_id":"1"},"method":"GET","queryParams":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","token_id":"1"},"type":"http"},"output":{"example":{"data":{"attributes":[{"trait_type":"Background","value":"Orange"}],"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","image":"ipfs://QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi","name":"Bored Ape #1","token_id":"1","token_uri":"ipfs://QmeSjSinHpPnmXmspMjwiXyN6zS4E9zccariGR3jxcaWtq/1"},"error":null,"meta":{"cost_usdc":"0.008","endpoint":"/api/chain/nft-metadata","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"contract":{"description":"NFT contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["contract","token_id"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"NFT contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["contract","token_id"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["NFT metadata","tokenURI","traits","attributes","NFT image","IPFS","ERC721","ERC1155","NFT JSON"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.008","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Fetch the metadata JSON, image URI, and traits for a specific NFT","Display an NFT gallery with names and images","Filter an NFT collection by trait values","Resolve ipfs:// URIs to a gateway-accessible URL"]}},"/api/chain/nft-owner":{"get":{"description":"Returns the current owner of a specific ERC721 NFT via eth_call on ownerOf(tokenId). Reverts for unminted or burned token IDs - the error surfaces as an RPC error.","operationId":"chainNftOwner","parameters":[{"description":"NFT contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Token ID","in":"query","name":"token_id","required":true,"schema":{"pattern":"^[0-9]+$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Look up the current owner of an ERC721 NFT by token_id via ownerOf (eth_call)","tags":["blockchain","ethereum","onesource","rpc","live-data","nft"],"x-bazaar":{"info":{"input":{"body":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","token_id":"1"},"method":"GET","queryParams":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","network":"ethereum","token_id":"1"},"type":"http"},"output":{"example":{"data":{"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d","owner":"0x46eFBAedc92067E6d60E84ED6395099723253D67","token_id":"1"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/nft-owner","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"contract":{"description":"NFT contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["contract","token_id"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"NFT contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"token_id":{"description":"Token ID","pattern":"^[0-9]+$","type":"string"}},"required":["contract","token_id"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["NFT owner","ownerOf","ERC721","current holder","NFT lookup","NFT verification"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Find out who currently owns a specific NFT","Verify a user claims to own an NFT by checking on-chain","Detect NFT ownership transfers","Reconstruct NFT provenance from ownership snapshots"]}},"/api/chain/nonce/{address}":{"get":{"description":"Returns the number of transactions sent from this address via eth_getTransactionCount. Pass block=\"pending\" (default) for the next-nonce an EIP-1559 or legacy transaction should use, or a confirmed tag for historical nonces. Use this to build a correctly-nonced transaction or to diagnose stuck transactions.","operationId":"chainNonce","parameters":[{"description":"Wallet address","in":"path","name":"address","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Block tag (default: \"pending\")","in":"query","name":"block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Next transaction nonce for any Ethereum wallet via eth_getTransactionCount - how many txs it has sent","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum"},"method":"GET","queryParams":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","block":"pending","nonce":"0x4d2"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/nonce/{address}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"block":{"description":"Block tag (default: \"pending\")","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Wallet address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"block":{"description":"Block tag (default: \"pending\")","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["nonce","transaction count","next nonce","sequential nonce","stuck transaction","eth_getTransactionCount"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Get the next nonce to include in a signed transaction","Count how many transactions a wallet has sent historically","Detect stuck transactions by comparing pending vs latest nonce","Build a replacement transaction at the right nonce"]}},"/api/chain/pending":{"get":{"description":"Returns the pending block as seen by the upstream RPC node - transactions that are in the mempool but not yet included on-chain, via eth_getBlockByNumber(\"pending\"). Use this to monitor unconfirmed activity, spot front-running risk, or peek at what a node plans to mine next.","operationId":"chainPending","parameters":[{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Pending Ethereum block - mempool transactions not yet mined, via eth_getBlockByNumber(\"pending\")","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"network":"ethereum"},"method":"GET","queryParams":{"network":"ethereum"},"type":"http"},"output":{"example":{"data":{"hash":null,"number":"0x133da1f","transaction_count":182},"error":null,"meta":{"cost_usdc":"0.010","endpoint":"/api/chain/pending","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["pending block","mempool","unconfirmed transactions","pending transactions","front-running","eth_getBlockByNumber"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.010","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Monitor unconfirmed transactions in the Ethereum mempool","See what a node plans to mine next","Detect front-running or high-priority transactions before inclusion"]}},"/api/chain/proxy/{address}":{"get":{"description":"Reads well-known proxy storage slots via eth_getStorageAt to detect EIP-1967, UUPS, and Transparent proxy patterns, and returns the current implementation address. Also surfaces the admin slot when present.","operationId":"chainProxy","parameters":[{"description":"Proxy contract address","in":"path","name":"address","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Detect upgradeable proxy patterns (EIP-1967, UUPS, Transparent) via eth_getStorageAt - returns the implementation address behind a proxy","tags":["blockchain","ethereum","onesource","rpc","live-data","proxy","smart-contract"],"x-bazaar":{"info":{"input":{"body":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"method":"GET","queryParams":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"address":"0xdac17f958d2ee523a2206206994597c13d831ec7","implementation":null,"is_proxy":false,"pattern":null},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/proxy/{address}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"address":{"description":"Proxy contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"address":{"description":"Proxy contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["address"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["proxy contract","EIP-1967","UUPS","Transparent proxy","upgradeable contract","implementation address","admin slot","proxy detection"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Find the implementation contract behind an upgradeable proxy","Detect which proxy pattern a contract uses","Audit that a proxy's admin slot points where expected","Follow a proxy upgrade history by polling the implementation slot"]}},"/api/chain/receipt/{hash}":{"get":{"description":"Returns the mined transaction receipt - status (success/failed), gas used, effective gas price, emitted event logs, and block inclusion data - via eth_getTransactionReceipt. Returns null if the transaction is pending or unknown to the node.","operationId":"chainReceipt","parameters":[{"description":"Transaction hash","in":"path","name":"hash","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Transaction receipt via eth_getTransactionReceipt - status, gas, and event logs for a mined Ethereum transaction","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","network":"ethereum"},"method":"GET","queryParams":{"hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"block_number":"0x133da1e","effective_gas_price":"0x3b9aca00","gas_used":"0x5208","logs":[],"status":"0x1","transaction_hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f"},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/receipt/{hash}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"hash":{"description":"Transaction hash","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["hash"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"hash":{"description":"Transaction hash","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["hash"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["transaction receipt","tx status","tx reverted","gas used","event logs","confirmation","eth_getTransactionReceipt"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check whether a transaction succeeded or reverted","Read the event logs emitted by a specific transaction","Get the effective gas price paid by a transaction","Confirm a transaction was included in a block"]}},"/api/chain/storage":{"get":{"description":"Reads a 32-byte storage slot directly from a contract's storage via eth_getStorageAt. Useful for inspecting EIP-1967 proxy implementation slots, packed variables, and storage layouts that aren't exposed through a public function.","operationId":"chainStorage","parameters":[{"description":"Contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Storage slot (hex)","in":"query","name":"slot","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}},{"description":"Block tag (default: \"latest\")","in":"query","name":"block","required":false,"schema":{"oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Read a raw storage slot from any Ethereum contract via eth_getStorageAt","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum","slot":"0x0"},"method":"GET","queryParams":{"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum","slot":"0x0"},"type":"http"},"output":{"example":{"data":{"block":"latest","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","slot":"0x0","value":"0x0000000000000000000000000000000000000000000000000000000000000001"},"error":null,"meta":{"cost_usdc":"0.005","endpoint":"/api/chain/storage","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"block":{"description":"Block tag (default: \"latest\")","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"contract":{"description":"Contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"slot":{"description":"Storage slot (hex)","pattern":"^0x[a-fA-F0-9]+$","type":"string"}},"required":["contract","slot"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"block":{"description":"Block tag (default: \"latest\")","oneOf":[{"minimum":0,"type":"integer"},{"enum":["latest","pending","earliest","safe","finalized"],"type":"string"},{"pattern":"^0x[a-fA-F0-9]+$","type":"string"}]},"contract":{"description":"Contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"},"slot":{"description":"Storage slot (hex)","pattern":"^0x[a-fA-F0-9]+$","type":"string"}},"required":["contract","slot"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["storage slot","contract storage","raw storage","proxy slot","implementation slot","packed storage","EIP-1967","eth_getStorageAt"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.005","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Inspect the implementation address stored in an EIP-1967 proxy slot","Read packed storage values not exposed through a contract function","Audit a contract's storage layout","Debug state drift between expected and actual on-chain storage"]}},"/api/chain/total-supply":{"get":{"description":"Returns the total supply of a token contract via eth_call on totalSupply(). Works for ERC20 (raw token units) and ERC721 (count of minted NFTs) contracts that implement the standard.","operationId":"chainTotalSupply","parameters":[{"description":"Token contract address","in":"query","name":"contract","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{40}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Total supply of an ERC20 or ERC721 token contract via totalSupply (eth_call)","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"method":"GET","queryParams":{"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","decimals":6,"symbol":"USDT","total_supply":"39283948340000000"},"error":null,"meta":{"cost_usdc":"0.003","endpoint":"/api/chain/total-supply","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"contract":{"description":"Token contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["contract"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"contract":{"description":"Token contract address","pattern":"^0x[a-fA-F0-9]{40}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["contract"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["total supply","token supply","circulating supply","mint count","NFT collection size","totalSupply"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.003","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Check the total supply of an ERC20 token","Count how many NFTs have been minted in an ERC721 collection","Compute a token's market cap alongside a price feed","Detect supply changes after a mint or burn"]}},"/api/chain/tx/{hash}":{"get":{"description":"Returns the full transaction object - from, to, value, gas, nonce, calldata, block inclusion - via eth_getTransactionByHash. Returns null if the transaction is pending eviction or unknown to the node.","operationId":"chainTx","parameters":[{"description":"Transaction hash","in":"path","name":"hash","required":true,"schema":{"pattern":"^0x[a-fA-F0-9]{64}$","type":"string"}},{"description":"Blockchain network","in":"query","name":"network","required":false,"schema":{"default":"ethereum","enum":["ethereum"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successful response"},"402":{"description":"Payment Required - include x402 payment in Payment-Signature header"}},"summary":"Full Ethereum transaction details by hash via eth_getTransactionByHash - from, to, value, calldata, block","tags":["blockchain","ethereum","onesource","rpc","live-data"],"x-bazaar":{"info":{"input":{"body":{"hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","network":"ethereum"},"method":"GET","queryParams":{"hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","network":"ethereum"},"type":"http"},"output":{"example":{"data":{"block_number":"0x133da1e","from":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","gas":"0x5208","hash":"0xad7e04119ecd85857728205f5b12e95f0bab8e99f9c2f60be5dc79cfc6a8df1f","nonce":"0x4d2","to":"0xdac17f958d2ee523a2206206994597c13d831ec7","value":"0x0"},"error":null,"meta":{"cost_usdc":"0.008","endpoint":"/api/chain/tx/{hash}","payment_chain":"base","payment_token":"USDC","request_id":"00000000abcdef01"}},"type":"json"}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"hash":{"description":"Transaction hash","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["hash"],"type":"object"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"properties":{"hash":{"description":"Transaction hash","pattern":"^0x[a-fA-F0-9]{64}$","type":"string"},"network":{"default":"ethereum","description":"Blockchain network","enum":["ethereum"],"type":"string"}},"required":["hash"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Response payload","type":"object"},"error":{"type":["object","null"]},"meta":{"properties":{"cost_usdc":{"type":"string"},"endpoint":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"},"request_id":{"type":"string"}},"type":"object"}},"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"}},"x-keywords":["transaction details","tx lookup","transaction by hash","calldata","transaction value","from to","eth_getTransactionByHash"],"x-payment-info":{"payTo":"0x52E29e0d2Aa49bfBfC548C0A9F2196F4aa51f3ea","price":{"amount":"0.008","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]},"x-use-cases":["Look up the full payload of a specific transaction by hash","Inspect the calldata of a contract interaction","Find which block a transaction was mined in","Read the value and gas settings of any Ethereum transaction"]}}},"x-discovery":{"ownershipProofs":["0x2b2e0a105642c4b7fd1461957b83acdf66a726cc366147dce9c4077d5d09878e645e71a7a7c87f8ce7a6e4f760a87d88b97255690715b136c07fa1be929d9e5b1c"]},"x-service-info":{"categories":["blockchain","data","developer-tools"],"docs":{"apiReference":"https://skills.onesource.io/openapi.json","homepage":"https://onesource.io"}}}