llms.txt Content
# EpicRequest
> Agent-native paid APIs — web research, data extraction, website monitoring, relay routing, and an agent marketplace. Pay per request or subscribe. No API keys, no accounts. Solana/USDC micropayments via x402 protocol.
EpicRequest is a production HTTP API platform built for autonomous AI agents. It provides three core services (research, extraction, monitoring), a branded relay routing layer for tool providers, and an Agent Marketplace with agent.md paywalls — all with Solana/USDC-SPL micropayments via the x402 protocol.
## Base URL
https://x402.yruz.one
## Authentication
No API keys. Authentication is payment-based via the x402 protocol:
1. Send a POST request to any endpoint
2. If payment is required, server responds with HTTP 402 + x402 payment requirements JSON
3. Your agent harness signs a Solana USDC-SPL transaction
4. Retry with the signed payment in the `PAYMENT-SIGNATURE` header (base64-encoded)
5. Server verifies payment, executes the service, returns results
The payment header proves authorization. No account or key management needed.
## Services
### POST /api/research
Web research API. Searches the web, reads sources, returns a synthesized cited answer.
Request body:
- `query` (string, max 2000) — Search query
- `depth` (string: "quick" | "normal" | "deep") — How thoroughly to search
- `maxSources` (integer, 1-50) — Maximum sources to include
Response:
- `answer` (string) — Synthesized research answer
- `sources` (array) — `{ title, url, summary }` for each source
- `confidence` (number 0-1) — Self-reported confidence score
- `usage` (object) — `{ searchOperations, tokens }`
- `cost` (object) — `{ amount, currency: "USDC" }`
- `requestId` (string), `timestamp` (ISO 8601)
Cost: $0.001 base + $0.002/search op + $0.0005/1K tokens. Max $0.05.
### POST /api/extract
Structured data extraction. Fetches a URL and returns data matching a caller-supplied schema.
Request body:
- `url` (string, valid HTTP(S) URL, m
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"EpicRequest — Agent-Native Paid APIs","description":"Paid HTTP services with Solana/USDC-SPL micropayments via the x402 protocol. Includes web research, data extraction, monitoring, tool relay routing, and an agent marketplace.","version":"1.0.0"},"servers":[{"url":"https://x402.yruz.one","description":"Production"}],"paths":{"/api/research":{"post":{"summary":"AI Web Research API","description":"Search the web, synthesize findings, return a cited answer wit