Real-time Hyperliquid trader analytics, market sentiment, technical indicators, and cohort intelligence. Pay-per-request in USDC via the x402 protocol — no subscription, no API keys.
Make a GET request to any endpoint. If no payment is attached, you get a 402 response with payment instructions.
Send USDC on Base to the facilitator. x402 client libraries handle this automatically.
Retry with the payment receipt in the X-PAYMENT header. Data is returned instantly.
import { wrapAxiosWithPayment, x402Client } from "@x402/axios";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";
import axios from "axios";
const signer = createWalletClient({
account: privateKeyToAccount(process.env.PRIVATE_KEY),
chain: base,
transport: http(),
});
const client = new x402Client();
registerExactEvmScheme(client, { signer });
const api = wrapAxiosWithPayment(
axios.create({ baseURL: "https://api.otomate.trade/api/v1" }),
client
);
// Automatically handles 402 → pay USDC → retry
const whales = await api.get("/leaderboard?sort=equity&cohort=WHALE&limit=10");
const btcSentiment = await api.get("/market/sentiment?coin=BTC");
const indicators = await api.get("/indicators/BTC");
const fundingHistory = await api.get("/funding-rates/history?symbol=BTC-PERP&hours=48");Install: npm install @x402/axios @x402/evm viem axios (TypeScript) or pip install x402 (Python)
Settlement: USDC on Base mainnet. Facilitated by x402.org.
Base URL: https://api.otomate.trade/api/v1
All errors return a structured JSON body with a machine-readable code and human-readable message. Some errors include a details object with valid values.
| Code | Status | Description |
|---|---|---|
| INVALID_ADDRESS | 400 | Address must be 0x followed by 40 hex characters |
| WALLET_NOT_FOUND | 404 | No wallet data found for this address |
| INVALID_SORT | 400 | Invalid sort parameter — returns valid options in details |
| INVALID_COHORT | 400 | Invalid cohort tier — returns valid tiers in details |
| INVALID_TIMEFRAME | 400 | Invalid timeframe — valid: 1d, 7d, 30d, 90d |
| INVALID_ASSET | 400 | Unsupported asset — valid: BTC, ETH, SOL |
| TRADER_NOT_FOUND | 404 | No trader data found for this address |
| DATA_NOT_READY | 503 | Data not yet computed — retry in 30 seconds |
| RATE_LIMIT_EXCEEDED | 429 | Too many requests — limit: 60/min |
| INTERNAL_ERROR | 500 | Unexpected server error |
{
"error": {
"code": "INVALID_SORT",
"message": "Invalid sort parameter: xyz",
"details": { "validValues": ["score", "pnl", "roi", "equity", "..."] }
}
}RateLimit-Limit— Max requests per window (60)RateLimit-Remaining— Requests left in current windowRateLimit-Reset— Seconds until window resetsCached endpoints include a meta.cache object with TTL and source. Non-cached endpoints query the database directly.
| Endpoint | TTL | Source |
|---|---|---|
| /indicators/:asset | 60s | Redis |
| /market/sentiment | 10 min | Redis |
| /market/cohort-bias | 30 min | Redis |
| /wallets, /leaderboard | None | DB |
| /funding-rates/history | None | DB |
| /wallets/:address/trades | None | DB |
Two free discovery endpoints let AI agents (OpenClaw, LangChain, CrewAI, ChatGPT plugins, etc.) auto-discover and integrate the Otomate Data API without any payment or authentication.
/api/v1/openapi.jsonNo payment requiredFull OpenAPI 3.1 specification — all 10 endpoints, parameters, response schemas, and x402 payment info. Feed this URL directly to any LLM or agent framework for automatic tool generation.
curl https://api.otomate.trade/api/v1/openapi.json/.well-known/ai-plugin.jsonNo payment requiredAI plugin manifest following the standard /.well-known/ convention. Declares the API name, capabilities, auth method (none — x402 handles payment), and links to the OpenAPI spec.
curl https://api.otomate.trade/.well-known/ai-plugin.json# 1. Discover the API (free — no payment needed)
spec=$(curl -s https://api.otomate.trade/api/v1/openapi.json)
# 2. Feed to your agent framework
# - OpenClaw: register as external tool via OpenAPI URL
# - LangChain: OpenAPIToolkit.from_openapi_spec(spec)
# - CrewAI: add as tool with OpenAPI schema
# - ChatGPT: use /.well-known/ai-plugin.json for plugin discovery
# 3. Agent calls endpoints — x402 handles payment automatically
# Agent wallet needs USDC on Base (< $0.02 per request)Built by Otomate. Powered by x402 + USDC on Base.