API Overview
Base URL
Authentication
HYRE uses x402 payment instead of API keys. Every paid request must include anX-PAYMENT header with a signed payment payload.
- Call the endpoint without payment to receive a 402 challenge.
- Sign the payment with your wallet.
- Retry with the
X-PAYMENTheader attached.
Standard Response Format
Every paid endpoint returns theHyreResponse envelope:
List of upstream data sources used (e.g.,
["defillama"], ["solana-rpc", "jupiter"]).Signal Vocabulary
Each endpoint segment uses a specific set of signals:HTTP Status Codes
Request Methods
All endpoints support bothGET and POST:
- POST (recommended)
- GET (legacy)
Parameters in the JSON body. Preferred for x402 compatibility.
OpenAPI Specification
The full OpenAPI 3.1 spec is available at:x-payment-info extensions for every endpoint with pricing, network details, and facilitator URLs.