{"uid":"cap_AOQcOnJMe12fUOihFsKPh","slug":"chainquery-getnodeaddresses-3663552b","name":"chainquery getnodeaddresses","description":"chainquery Bitcoin RPC: pay-per-call Bitcoin Core over x402, no API key. Known peer addresses from the node's address manager. Bitcoin Core getnodeaddresses.","url":"https://x402.chainquery.com/v1/rpc/getnodeaddresses","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":{"params":{"type":"string","description":"optional: JSON-encoded array of positional RPC params"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"result":{"description":"getnodeaddresses result"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"params":"[10]"}}},"response":{"result":[{"port":8333,"time":1781394274,"address":"2001:470:59b4::ff","network":"ipv6","services":3085},{"port":8333,"time":1781600451,"address":"2a0b:6204:20f7:b00:a403:f49a:9dd1:e2fb","network":"ipv6","services":1032},{"port":8333,"time":1781673145,"address":"70.116.10.244","network":"ipv4","services":738200653},{"port":8333,"time":1781733456,"address":"173.0.155.25","network":"ipv4","services":3081},{"port":8333,"time":1781672554,"address":"2a05:d01c:672:9200:1104:4e23:15f9:88f5","network":"ipv6","services":1037},{"port":8333,"time":1781081312,"address":"2001:fd8:c959:5100:4134:d95d:8f27:2c92","network":"ipv6","services":134220808},{"port":8333,"time":1781703636,"address":"193.9.116.101","network":"ipv4","services":3080},{"port":9333,"time":1781719453,"address":"109.234.177.180","network":"ipv4","services":134220873},{"port":8333,"time":1781687337,"address":"120.155.79.106","network":"ipv4","services":3080},{"port":8333,"time":1781699963,"address":"2603:6010:9e01:5fec:d9a3:808d:9d07:4b3e","network":"ipv6","services":67111948}]}},"exampleRequest":{"params":"[10]"},"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Y8WaxSq3aTYQwIWfQDKPM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns known peer addresses from the Bitcoin Core node's address manager via pay-per-call RPC","exampleAgentPrompt":"Give me a list of known peer addresses from the Bitcoin Core node — use getnodeaddresses and return up to 10 results.","exampleUseCases":[{"title":"Discover live Bitcoin network peers","prompt":"Can you pull a list of known Bitcoin peer addresses from the network right now? I want to see which nodes are out there — grab me up to 20 results with their IPs, ports, and network types."},{"title":"Monitor Bitcoin P2P node diversity","prompt":"I'm analyzing the Bitcoin P2P network. Fetch me a fresh batch of known peer addresses from the node's address manager so I can check how many are IPv4 vs IPv6 vs Tor nodes."},{"title":"Bootstrap Bitcoin node connection list","prompt":"I need a set of known Bitcoin Core peer addresses to seed a new connection list. Pull as many peer entries as you can from the node's address manager and give me their IPs and ports."}],"resultDescription":"A JSON object with a 'result' field containing an array of known peer address entries from the Bitcoin Core node's address manager, each including IP address, port, network type, and service flags.","failureModes":["Invalid JSON in params query parameter returns RPC parse error","Requesting more addresses than available returns fewer results with no error","Node connectivity issues may return an empty array","Payment failure (402) if USDC balance is insufficient","Malformed GET request returns 400 bad request"],"whenToPreferThis":"Use this endpoint when you need to discover known Bitcoin network peers without running your own node, want pay-per-call access with no API key setup, and need real data from a live Bitcoin Core instance via the x402 micropayment protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:56:13.345Z","isFirstParty":false}