{"uid":"cap_b1wvcH1Ce8wt5XDX-CeTy","slug":"agentshelf-base-eth-call-6e9bc989","name":"AgentShelf Base eth_call","description":"Call when an agent needs a read-only Base eth_call. Send to and data (hex) or a function signature plus args. Optional from and block. Reverts return a decoded reason. No state change and no spend. Send JSON {\"to\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"data\":\"0x18160ddd\"}. Exact $0.004 USDC on Base. Try unpaid POST /v1/sandbox/base-eth-call first.","url":"https://agentshelf.syntexa.ch/v1/base-eth-call?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","examples":["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],"description":"Contract to call on Base. Example: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913. The call is eth_call with no value, so it cannot change state."},"args":{"type":"string","maxLength":2048,"minLength":2,"description":"JSON array of arguments. Example: [\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"]. A POST array is accepted. Requires signature."},"data":{"type":"string","pattern":"^0x[0-9a-fA-F]*$","examples":["0x18160ddd"],"description":"Calldata, 0x hex, at most 2048 characters. Example: 0x18160ddd (totalSupply()). Send data or signature, not both. eth_call cannot change state."},"from":{"type":"string","description":"Optional eth_call from address. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045. It is not a transaction sender and nothing is spent."},"block":{"type":"string","description":"Block tag or number for eth_call. latest, finalized, safe, or a non-negative integer. Omit it for latest. The call is read-only."},"signature":{"type":"string","maxLength":180,"minLength":3,"description":"Function signature. Example: decimals() or balanceOf(address)(uint256). args is a JSON array when the function has parameters. Send signature or data, not both."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__o3JSsvnJhkEq-V34D7Tb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Executes a read-only eth_call on Base mainnet and returns the decoded result or revert reason, with no state change and no gas spend.","exampleAgentPrompt":"What is the total supply of USDC on Base? Call the totalSupply() function on contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 using a read-only eth_call.","exampleUseCases":[{"title":"Check ERC-20 token total supply","prompt":"What's the total supply of USDC on Base? The contract address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — use the totalSupply() function."},{"title":"Read token balance for a wallet","prompt":"How many USDC tokens does 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 hold on Base? Use balanceOf(address) on the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Query token decimals for price math","prompt":"What are the decimals for the token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base? Call the decimals() function so I can format the amounts correctly."}],"resultDescription":"Returns the decoded output of the eth_call — typically a typed value such as a uint256, address, or string. If the call reverts, returns a decoded revert reason string. No transaction is submitted and no state is modified.","failureModes":["Invalid contract address returns an error","Malformed or mismatched calldata/signature causes a revert with decoded reason","Specifying both 'data' and 'signature' returns a validation error","Invalid block tag or number returns an error","Network or RPC unavailability causes a 5xx response","Payment not included or insufficient returns a 402 Payment Required (try sandbox first)"],"whenToPreferThis":"Use this endpoint when an agent needs to read on-chain state from Base mainnet without submitting a transaction — e.g. querying token balances, supply, decimals, or any view/pure function. Prefer it over general RPC nodes when you want a simple HTTP POST interface with decoded results and clear revert reasons. The sandbox endpoint (/v1/sandbox/base-eth-call) is available for free testing before committing the $0.004 USDC fee.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:48:09.031Z","isFirstParty":false,"canonicalSlug":"agentshelf-base-eth-call-6e9bc989"}