{"uid":"cap_1BTVjTxzOBNPRzZPIVNVC","slug":"asn-neighbours-lookup-0ebe345a","name":"ASN Neighbours Lookup","description":"Returns the neighbouring autonomous systems observed next to a given AS in BGP paths, each with the number of observers that saw the adjacency and how often it appeared, which together indicate how solid the observation is rather than how important the relationship is.","url":"https://netz.halowerk.com/v1/asn-neighbours","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asn":{"type":"string","maxLength":15,"minLength":1},"min_peers":{"type":"integer","default":3,"maximum":100,"minimum":1,"description":"Adjacencies seen by fewer observers than this are marked weak."},"compare_days_ago":{"type":"integer","maximum":365,"minimum":1,"description":"Compare against the neighbour set this many days ago."}}},"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_Xq-4-UsgVt0nNCIedXgI-","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":"Returns the neighbouring autonomous systems observed adjacent to a given AS in BGP paths, with observer counts and adjacency frequency indicating observation confidence.","exampleAgentPrompt":"What autonomous systems are BGP neighbours of AS15169? I want to know which ASes appear next to it in observed BGP paths, how many RIS observers saw each adjacency, and how often each one appeared.","exampleUseCases":[{"title":"Mapping ISP peering topology","prompt":"Show me all the BGP neighbours of AS3320 — I need to see which autonomous systems appear adjacent to it in routing paths, along with how many observers confirmed each adjacency."},{"title":"Investigating unexpected AS adjacency","prompt":"I'm seeing unusual traffic patterns and want to check whether AS64496 has any unexpected BGP neighbours. Can you pull the list of observed neighbours for AS64496 and tell me how confident the observations are based on observer count and frequency?"},{"title":"Pre-merger AS relationship audit","prompt":"We're auditing AS7922 before an acquisition — can you get all the autonomous systems observed as BGP neighbours of AS7922, including how many times each adjacency appeared and how many BGP observers saw it?"}],"resultDescription":"A list of neighbouring autonomous systems observed adjacent to the queried ASN in BGP paths. Each neighbour entry includes the neighbour's ASN, the number of distinct BGP observers (RIS peers) that saw the adjacency, and the count of how often that adjacency appeared in BGP paths — together indicating the reliability and solidity of the observed peering relationship.","failureModes":["Invalid or non-existent ASN returns an error or empty neighbour list","ASN with very limited BGP visibility may return few or no neighbours","Stale data if BGP observations have not been refreshed recently","Malformed request body returns a 400-level error"],"whenToPreferThis":"Use this endpoint when you need to understand the observed BGP topology around a specific autonomous system — particularly which ASes are directly adjacent in routing paths and how well-attested those adjacencies are. Prefer this over passive BGP route tables when you want observation confidence metrics (observer count + frequency). It complements RPKI validation and route hijack detection endpoints for full routing security analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:41:00.196Z","isFirstParty":false}