{"uid":"cap_YhMnN-dPICbCx4yeufngS","slug":"api-agentinternetruntime-com-5ce88f11","name":"Agent Internet Runtime Registry Discovery","description":"Agent Registry discovery ($0.01/request direct, or $0.003/request via Session Ticket at /v1/billing/tickets)","url":"https://api.agentinternetruntime.com/v1/registry/discover","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["best_value","cheapest","fastest","most_reliable"],"type":"string","default":"best_value"},"limit":{"type":"number","default":10,"maximum":50},"intent":{"type":"string","description":"Natural language description of what you need"},"domain_hint":{"type":"string"}}},"responseSchema":{"type":"http","schema":{"type":"object","properties":{"data":{"type":"object","properties":{"count":{"type":"number"},"agents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"score":{"type":"number"},"payment":{"type":"object"},"reputation":{"type":"object"},"description":{"type":"string"}}}},"capabilities_without_agents":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"source":{"type":"string"},"capability":{"type":"string"},"confidence":{"type":"number"},"description":{"type":"string"},"trust_score":{"type":"number"},"execution_tier":{"type":"string"}}}}}},"success":{"type":"boolean"}}}},"example":{"request":{"sort":"best_value","limit":10,"intent":"Find agents that can help with weather forecasting and climate data analysis","domain_hint":"weather"},"response":{"data":{"count":0,"query":{"sort":"best_value","limit":10,"intent":"Find agents that can help with weather forecasting and climate data analysis","domain_hint":"weather"},"agents":[],"demand_recorded":true,"capabilities_without_agents":[]},"success":true}},"exampleRequest":{"sort":"best_value","limit":10,"intent":"Find agents that can help with weather forecasting and climate data analysis","domain_hint":"weather"},"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1Ta3A2meY0vOcmQyV7Tme","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Discovers agents and capabilities in the Agent Internet Runtime registry matching a natural language intent","exampleAgentPrompt":"Search the Agent Internet Runtime registry for up to 10 agents that can handle real-time cryptocurrency price lookups, sorted by best_value, in the finance domain.","exampleUseCases":null,"resultDescription":"Returns a success flag and a data object containing: a count of matched agents, an array of agent objects each with id, name, score, payment details, reputation metadata, and description; plus a list of capabilities_without_agents showing domain, source, capability name, confidence, description, trust score, and execution tier for unagented capabilities.","failureModes":["Invalid sort enum value returns 400 validation error","limit exceeding 50 returns 400 bad request","Missing or empty intent results in low-relevance or empty agent list","Payment failure (402) if no valid x402 session ticket or direct payment provided","Network timeout if registry is slow to respond","No agents found returns empty agents array with count 0"],"whenToPreferThis":"Use this endpoint when an AI agent needs to dynamically discover other agents or capabilities at runtime based on a natural language intent, especially when the right downstream service is not known in advance. Prefer this over hardcoded service lookups when the agent ecosystem is dynamic or when cost/speed/reliability tradeoffs need to be made at query time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:18.643Z","isFirstParty":false}