[ 00 ] Live · USDC on Base mainnet

DeFi APIs.
Priced per call.

Sixteen production endpoints. Bundle 1–10 paid calls into one settlement. ~2 seconds on Base, $0.005 to $0.20 per call. No keys, no signups — the signed USDC payment is the auth.

$ curl -i https://api.hyperd.ai/api/wallet/pnl?address=0xd8dA…6045

HTTP/2 402 Payment Required
payment-required: eyJ4NDAyVmVyc2lvbiI6Mi4uLg==
content-type: application/json

{ "x402Version": 2, "accepts": [{
    "scheme": "exact",
    "network": "eip155:8453",
    "amount": "50000",
    "asset": "0x833589…02913",
    "payTo": "0x61b5…c6"
}]}

Install in Claude Desktop 30-line Python demo

[ 01 ] What it is

An on-chain HTTP economy for agents.

One signed payment. One response.

The agent sends a normal GET, the server returns HTTP 402 with the payment terms, the agent signs an EIP-3009 USDC authorization on Base, retries with an X-Payment header. Coinbase's facilitator settles in ~2 seconds. The signature is the auth — no key store, no rotation, no rate-limit form to fill.

Real DeFi data, not a polished demo.

Aave V3 / Compound v3 / Spark / Morpho liquidation health. GoPlus security scoring. Chainalysis Sanctions. DefiLlama's full yield universe. Farcaster sentiment. Snapshot + Tally proposal summaries via Claude / GPT-4o-mini. Every endpoint reads from the canonical source — there is no "synthetic" data on this site.

Built for agents that pay their own way.

An agent with a $5 hot wallet on Base can call sixteen endpoints, save state across runs, set its own spending caps, bundle expensive risk checks into a single $0.20 settlement, and never need a human in the loop. No subscriptions, no monthly minimums, no sales call to unlock the API. npx -y hyperd-mcp and you are running.

[ 02 ] Catalog

16.

Endpoints, plus bundle.

POST /api/bundle	★ Bundle 1 – 10 paid GETs in one x402 settlement. Saves up to 33% vs à la carte and 9 round-trips. The marquee v1.0 endpoint.	$0.20 fixed
GET /api/wallet/pnl	Wallet P&L Realized + unrealized P&L over a window. ERC-20 + native, FIFO / LIFO / HCFO. Per-token breakdown with mark-to-market.	$0.05
GET /api/liquidation/risk	Liquidation risk Cross-protocol composite health factor. Aave V3 / Compound v3 / Spark / Morpho. Pass `?chain=all` for an aggregate across seven EVM chains.	$0.10
GET /api/wallet/anomaly	Wallet anomaly Behavioural deviation against the wallet's own 180-day baseline. Built to catch compromised hot wallets and suddenly-active dormant whales.	$0.10
GET /api/budget/guardian	Budget guardian Agent USDC spend visibility plus an optional cap check. Designed to be called before the next paid call to enforce a self-imposed budget.	$0.01
GET /api/balance	Balance Multi-chain ERC-20 + native balance across Base, Ethereum, Polygon, Arbitrum, Optimism, Avalanche, BNB. `?chain=all` fans out in parallel.	$0.01
GET /api/yield	Yield Opinionated DeFi yield recommendation. DefiLlama universe filtered by risk tier, TVL floor, IL exposure, then ranked by APY.	$0.05
GET /api/token/info	Token info Aggregated metadata across CoinGecko and DefiLlama. Price, supply, listings, audits — one shot.	$0.01
GET /api/token/security	Token security GoPlus security risk score 0 – 100. Honeypot detection, owner permissions, taxes, holder concentration.	$0.05
GET /api/risk/wallet	Wallet risk Chainalysis Sanctions Oracle plus GoPlus heuristics. OFAC SDN authoritative.	$0.10
GET /api/contract/audit	Contract audit Pre-trade composite: GoPlus + Sourcify + DefiLlama + on-chain heuristics, normalised to a 0 – 100 risk score.	$0.10
GET /api/wallet/persona	Wallet persona Behavioural classification: Trader / HODLer / MEV bot / Whale / Smart-Money / Airdrop-Farmer / Compromised / Inactive.	$0.10
GET /api/governance/summarize	Governance summary Snapshot or Tally proposal analysed by Claude Sonnet or GPT-4o-mini. Who benefits, who pays, recommended position.	$0.10
GET /api/sentiment/token	Token sentiment Farcaster sentiment 0 – 100, volume, trend, and a sample of recent casts.	$0.05
GET /api/dex/quote	DEX quote Best swap route across multiple aggregators (Paraswap + 0x). Returns the highest output and the per-source quotes.	$0.02
GET /api/protocol/tvl	Protocol TVL DefiLlama protocol TVL, audit history, chain distribution.	$0.01
GET /api/gas/estimate	Gas estimate Gas price plus base fee plus tip percentiles, broken down for fast / standard / slow inclusion.	$0.005

Watch tier (subscription) — POST /api/watch/create at $3 / 30-day for HMAC-signed webhook alerts on liquidation thresholds. Currently in private preview.

[ 03 ] The protocol

Four steps. No sessions. No state.

01 / Request

Agent makes a normal GET.

No auth header. No API key. Just the URL.

02 / Challenge

Server responds 402.

The header carries chain, asset, price, payTo, scheme. Machine-readable.

03 / Sign

Agent signs EIP-3009.

USDC transfer authorization, scoped to this exact request. Done client-side.

04 / Settle

Server responds with data.

~2 seconds via Coinbase facilitator. Receipt headers prove on-chain settlement.

[ 04 ] Install

Drop into any MCP client. Or call HTTP directly.

Claude Desktop / Cursor / Cline / Zed

{
  "mcpServers": {
    "hyperd": {
      "command": "npx",
      "args": ["-y", "hyperd-mcp"],
      "env": { "HYPERD_WALLET_PRIVATE_KEY": "0x..." }
    }
  }
}

Add to claude_desktop_config.json with a hot wallet holding ≥ $5 USDC on Base. Twenty-three tools appear in the conversation tool list after restart.

HTTP (any language)

curl -i \
  "https://api.hyperd.ai/api/balance?address=0xd8dA…6045"

Returns 402 with payment requirements. Pair with @x402/axios, @x402/fetch, or any EIP-3009 signer to settle automatically. A reference Python implementation is in the demo repo.