{"openapi":"3.1.0","info":{"title":"FIND AGENTS","version":"10.0.0","description":"Search engine for agents. 100K+ x402, MCP, and MPP services indexed with real on-chain revenue data. Free discovery layer for the agentic web. Search, discover, and interact with any service — pay via x402 or MPP/Tempo. Powered by Valoria.","contact":{"name":"Valoria","url":"https://valoria.net"},"license":{"name":"MIT"},"guidance":"Valoria indexes every x402, MCP, and MPP service with real on-chain revenue. Use the free search/stats endpoints for discovery. Paid intelligence endpoints require USDC payment via x402 or MPP."},"servers":[{"url":"https://find-agents.com","description":"Valoria Search API"}],"x-mcp":{"endpoint":"https://find-agents.com/mcp","transport":"streamable-http","tools":["search","feeds","stats","domain-detail","try-x402","try-mpp"]},"x-agent-protocols":["x402","mcp","mpp","a2a"],"x-discovery":{"ownershipProofs":["eip155:8453:0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"]},"paths":{"/search":{"get":{"operationId":"search","summary":"Search the agent economy","description":"Find any x402, MCP, or MPP service by natural language query. Returns ranked results with real on-chain revenue data. Free.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search query — natural language, keyword, domain, or category"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100},"description":"Max results"},{"name":"type","in":"query","schema":{"type":"string","enum":["x402","mcp"]},"description":"Filter by service type"},{"name":"category","in":"query","schema":{"type":"string"},"description":"Filter by category"}],"responses":{"200":{"description":"Search results with revenue data","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/leaderboard":{"get":{"operationId":"leaderboard","summary":"Ranked leaderboard of top agent services","description":"Top services ranked by revenue, payments, or quality score. Filter by type (x402/mcp/mpp). Free.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"parameters":[{"name":"sortBy","in":"query","schema":{"type":"string","enum":["revenue","payments","score"],"default":"revenue"},"description":"Ranking metric"},{"name":"type","in":"query","schema":{"type":"string","enum":["x402","mcp","mpp"]},"description":"Filter by protocol type"},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100},"description":"Max results"}],"responses":{"200":{"description":"Leaderboard entries with rank, revenue, score","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/feeds":{"get":{"operationId":"feeds","summary":"Curated feeds — the front page of the agent economy","description":"Top earners by on-chain revenue, trending services, rising newcomers, hidden gems. Free.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"responses":{"200":{"description":"Curated feeds","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/stats":{"get":{"operationId":"stats","summary":"Economy-wide statistics","description":"Total services indexed, on-chain volume, payment counts, categories. Free.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"responses":{"200":{"description":"Statistics","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/domain/{domain}":{"get":{"operationId":"domainDetail","summary":"Full details for any indexed service","description":"All endpoints, prices, revenue data, seller info, and payment addresses. Free.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"},"description":"Domain name — e.g. api.arvos.xyz"}],"responses":{"200":{"description":"Domain detail","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/categories":{"get":{"operationId":"categories","summary":"Browse all categories in the agent economy","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"responses":{"200":{"description":"Category list","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/protocols":{"get":{"operationId":"protocols","summary":"All supported payment and discovery protocols","description":"x402, MPP/Tempo, MCP, A2A, OpenAPI — full protocol details and integration info.","tags":["Discovery (Free)"],"x-payment-info":{"authMode":"open"},"responses":{"200":{"description":"Protocol details","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/intelligence/pulse":{"post":{"operationId":"intelligencePulse","summary":"Market pulse — real-time agent economy snapshot","description":"Top earners, hottest categories, chain breakdown, LLM analysis. Powered by $148M+ in on-chain payment data.","tags":["Intelligence (Paid)"],"x-payment":{"scheme":"exact","price":"$1.00","network":"eip155:8453","payTo":"0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"},"x-payment-info":{"authMode":"payment","protocols":["mpp"],"pricingMode":"fixed","price":"1.000000"},"parameters":[],"responses":{"200":{"description":"Market pulse snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"topEarners":{"type":"array"},"categories":{"type":"array"},"analysis":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/intelligence/analyze":{"post":{"operationId":"intelligenceAnalyze","summary":"Deep competitive analysis of any x402 service","description":"Scores, revenue, competitors, percentile ranking, trajectory, and recommendations for any domain or service.","tags":["Intelligence (Paid)"],"x-payment":{"scheme":"exact","price":"$5.00","network":"eip155:8453","payTo":"0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"},"x-payment-info":{"authMode":"payment","protocols":["mpp"],"pricingMode":"fixed","price":"5.000000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Domain name, URL, or service identifier"}}}}}},"responses":{"200":{"description":"Service analysis report","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"score":{"type":"number"},"revenue":{"type":"number"},"competitors":{"type":"array"},"analysis":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/intelligence/pricing":{"post":{"operationId":"intelligencePricing","summary":"Data-driven pricing recommendation for your x402 service","description":"What should you charge? Based on comparable services, category benchmarks, and real revenue data.","tags":["Intelligence (Paid)"],"x-payment":{"scheme":"exact","price":"$10.00","network":"eip155:8453","payTo":"0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"},"x-payment-info":{"authMode":"payment","protocols":["mpp"],"pricingMode":"fixed","price":"10.000000"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"What you're building — natural language description or category"}}}}}},"responses":{"200":{"description":"Pricing recommendation with benchmarks","content":{"application/json":{"schema":{"type":"object","properties":{"recommended":{"type":"string"},"benchmarks":{"type":"array"},"analysis":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/intelligence/opportunities":{"post":{"operationId":"intelligenceOpportunities","summary":"Ranked profitable gaps in the agent economy","description":"Up to 50 ranked opportunities with demand score, competition level, and margin estimates.","tags":["Intelligence (Paid)"],"x-payment":{"scheme":"exact","price":"$25.00","network":"eip155:8453","payTo":"0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"},"x-payment-info":{"authMode":"payment","protocols":["mpp"],"pricingMode":"fixed","price":"25.000000"},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"type":"integer","default":50,"maximum":50,"description":"Max opportunities to return (default 50)"}}}}}},"responses":{"200":{"description":"Ranked opportunity list","content":{"application/json":{"schema":{"type":"object","properties":{"opportunities":{"type":"array"},"analysis":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/intelligence/market":{"post":{"operationId":"intelligenceMarket","summary":"Full market report: trends, concentration, builder playbook","description":"Executive summary, sector analysis, investment thesis, risk factors, and builder playbook. The complete picture of the agent economy.","tags":["Intelligence (Paid)"],"x-payment":{"scheme":"exact","price":"$50.00","network":"eip155:8453","payTo":"0xd84B351dE5e4a08111ae9c3fE3eeBD7208Ce03AA"},"x-payment-info":{"authMode":"payment","protocols":["mpp"],"pricingMode":"fixed","price":"50.000000"},"parameters":[],"responses":{"200":{"description":"Full market intelligence report","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"type":"string"},"sectors":{"type":"array"},"trends":{"type":"array"},"playbook":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}}}}