discover_paid_api
Find pay-per-request APIs for any capability using natural language. Returns ranked, verified endpoints with pricing, success rate, and latency. Input your intent or capability ID, set filters like max price or network, and get reliable options before calling.
Instructions
Discover pay-per-request API endpoints for a given capability.
Returns ranked, verified endpoints with pricing and reliability metrics. Use this to find APIs before calling them. The results include:
Endpoint URL and method
Price per call and payment network
Success rate and latency metrics
Provider information
After discovering, you can use call_paid_api to execute the endpoint.
Trust & safety:
"Verified" means the endpoint returns a valid x402 402 response -- it does not guarantee the quality or accuracy of the data returned after payment.
Endpoints are probed every 10 minutes. Check last_verified and success_rate to gauge reliability.
Fallback endpoints (unverified) have failed recent verification checks -- use with caution.
Prefer endpoints with success_rate >95% and verification within the last 24 hours.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| intent | Yes | Natural language description of what you want to do (e.g., "get current weather for London", "translate text to Spanish"). Provide this or capability_id. | |
| capability_id | No | Explicit capability ID if known (e.g., "weather.current", "translate.text"). Alternative to intent for precise matching. | |
| max_price | No | Maximum price per request in USD (e.g., 0.01 for 1 cent) | |
| network | No | Required blockchain network for payment | |
| ranking_preset | No | Ranking preference preset | |
| limit | No | Maximum number of endpoints to return (default: 5) |