{"uid":"cap_N-PpkhmQWQCD9RAfk1Dwc","slug":"onesource-ethereum-block-number-rpc-b38fffe5","name":"OneSource Ethereum Block Number RPC","description":"Latest Ethereum block height - current chain tip via eth_blockNumber","url":"https://api.onesource.io/api/chain/block-number","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"network":{"enum":["ethereum","sepolia","robinhood"],"type":"string","default":"ethereum"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"result":{"type":"string"}},"description":"Endpoint-specific response payload"},"meta":{"type":"object","required":["endpoint","request_id"],"properties":{"endpoint":{"type":"string"},"cost_usdc":{"type":"string"},"request_id":{"type":"string"},"payment_chain":{"type":"string"},"payment_token":{"type":"string"}}},"error":{"type":["object","null"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{"result":"0x133da1e"},"meta":{"endpoint":"/api/chain/block-number","cost_usdc":"0.001","request_id":"00000000abcdef01","payment_chain":"base","payment_token":"USDC"}}},"example":{"request":{"network":"sepolia"},"response":{"data":{"result":"0xa87b78"},"meta":{"endpoint":"/api/chain/block-number","request_id":"2fcd6aebe380e534"}}},"exampleRequest":{"network":"sepolia"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_85XBA1O2YC9SfQ1YHSFDk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current latest block number for Ethereum mainnet or Sepolia testnet from OneSource-operated nodes","exampleAgentPrompt":"What's the current block number on Ethereum mainnet right now?","exampleUseCases":null,"resultDescription":"A JSON object containing the network name (e.g. 'ethereum') and the current block number as a hex string (e.g. '0x133da1e'), representing the latest confirmed block on the requested Ethereum network.","failureModes":["Invalid network enum value returns an error — only 'ethereum' and 'sepolia' are accepted","Payment failure via x402 (USDC on Base) prevents the call from being processed","Node unavailability or network outage may cause timeouts or 5xx errors","Hex block number may confuse consumers expecting a decimal integer — conversion required"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time Ethereum chain head data without managing API keys, and wants to pay per call using USDC on Base via x402 or pathUSD/USDC.e on Tempo. Ideal for agents that need lightweight block height checks on mainnet or Sepolia testnet as a building block for polling, confirmation tracking, or chain sync verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:46.826Z","isFirstParty":false}