{"openapi":"3.1.0","info":{"title":"Harpd Agent Market API","version":"2026-08-27","description":"Public machine discovery and free Harpd Rank resources. Paid machine access is disabled by default and requires an explicitly configured testnet or production payment mode.","x-guidance":"For autonomous agents: call GET /api/agent/v1/rankings or /api/agent/v1/products/{slug} (free) to inspect Harpd Rank data. The paid GET /api/agent/v1/premium/rank-intelligence returns full Rank Intelligence (positions, movement, history, category summaries, #100 threshold) for 0.1 USDC on Base mainnet via x402, with no API key; the agent signs and settles USDC itself. Machine entry point: /.well-known/agent.json","contact":{"name":"Harpd Support","email":"harpdsupport@gmail.com"}},"servers":[{"url":"https://api.harpd.com"}],"paths":{"/api/agent/v1/catalog":{"get":{"operationId":"getAgentCatalog","security":[],"responses":{"200":{"description":"Machine-readable catalog"}}}},"/api/agent/v1/rankings":{"get":{"operationId":"getAgentRankings","security":[],"parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["overall","monthly","weekly"]}},{"name":"category","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Free Harpd Rank data"}}}},"/api/agent/v1/products/{slug}":{"get":{"operationId":"getAgentProduct","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Free product profile"},"404":{"description":"Not found"}}}},"/api/agent/v1/premium/demo":{"get":{"operationId":"getPremiumDemo","security":[],"responses":{"200":{"description":"Paid demo result"},"402":{"description":"Payment required"},"404":{"description":"Disabled in this environment"},"503":{"description":"Payment mode or facilitator is not fully configured"}}}},"/api/agent/v1/premium/rank-intelligence":{"get":{"operationId":"getRankIntelligence","security":[],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"scope","in":"query","schema":{"type":"string","enum":["overall","monthly","weekly"],"default":"weekly"}},{"name":"category","in":"query","schema":{"type":"string","enum":["all","seo","agents","ai-media","marketing","developer","productivity","people","design","social","writing","sales","business","games","education","health","ecommerce","directories","hiring","audio","crypto","agencies","security","travel","news","domains","leaderboards","real-estate","other"],"default":"all"}},{"name":"history_days","in":"query","schema":{"type":"integer","minimum":1,"maximum":90,"default":30}}],"responses":{"200":{"description":"Paid Rank intelligence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RankIntelligenceResponse"}}}},"400":{"description":"Invalid input"},"402":{"description":"Payment required with x402 Bazaar discovery metadata"},"409":{"description":"Payment replay rejected"},"503":{"description":"Payment or resource dependency unavailable"}}}},"/v1/agent/test":{"get":{"operationId":"getAgentTestResource","security":[],"responses":{"200":{"description":"Paid demo result"},"402":{"description":"Payment required"}}}},"/v1/payments/config":{"get":{"operationId":"getPaymentConfig","security":[],"responses":{"200":{"description":"Public payment configuration"}}}},"/v1/payments/health":{"get":{"operationId":"getPaymentHealth","security":[],"responses":{"200":{"description":"Non-sensitive payment health"}}}}},"components":{"schemas":{"EmptyInput":{"type":"object","additionalProperties":false},"RankingsInput":{"type":"object","properties":{"scope":{"type":"string"},"category":{"type":"string"}}},"ProductInput":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string"}}},"RankingsResponse":{"type":"object"},"ProductResponse":{"type":"object"},"PremiumDemoResponse":{"type":"object","properties":{"resource":{"type":"string"},"status":{"type":"string"},"request_id":{"type":"string"}}},"RankIntelligenceInput":{"type":"object","properties":{"scope":{"type":"string","enum":["overall","monthly","weekly"],"default":"weekly"},"category":{"type":"string","enum":["all","seo","agents","ai-media","marketing","developer","productivity","people","design","social","writing","sales","business","games","education","health","ecommerce","directories","hiring","audio","crypto","agencies","security","travel","news","domains","leaderboards","real-estate","other"],"default":"all"},"history_days":{"type":"integer","minimum":1,"maximum":90,"default":30}},"additionalProperties":false},"RankIntelligenceResponse":{"type":"object","required":["request_id","resource","generated_at","scope","category","summary","products","methodology"],"properties":{"request_id":{"type":"string"},"resource":{"const":"rank-intelligence-v1"},"generated_at":{"type":"string","format":"date-time"},"scope":{"type":"string","enum":["overall","monthly","weekly"]},"category":{"type":"string"},"summary":{"type":"object","properties":{"eligible_products":{"type":"integer"},"returned_products":{"type":"integer","maximum":100},"top_100_threshold_rp":{"type":"integer"},"approved_in_period":{"type":"integer"}},"required":["eligible_products","returned_products","top_100_threshold_rp","approved_in_period"]},"products":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"category":{"type":"string"},"position":{"type":"integer"},"previous_position":{"type":["integer","null"]},"movement":{"type":"string"},"rank_points":{"type":"integer"},"promotional_rank_points":{"type":"integer"},"history":{"type":"array"}},"required":["slug","title","category","position","movement","rank_points","promotional_rank_points","history"]}},"methodology":{"type":"object"}}}}}}