# DeFi Signals API

Paid market-data API for AI agents. Pay per request via x402 (exact scheme,
USDC on Base mainnet, eip155:8453). No signup, no API keys. Facilitator:
Coinbase CDP. OpenAPI contract: https://defi-signals.org/openapi.json

## Endpoints

- GET https://defi-signals.org/signals/daily — $0.05 (PREMIUM)
  One-call daily signal: market regime (Fear & Greed + price action),
  Base yields with 1d/7d APY deltas from proprietary history, and the best
  cross-venue funding-arbitrage setup. Ranked top_opportunities included.
- GET https://defi-signals.org/market/snapshot — $0.002
  BTC/ETH/SOL spot prices, 24h change, Crypto Fear & Greed index.
- GET https://defi-signals.org/defi/funding-rates?symbol=BTC — $0.005
  Cross-venue perpetual funding rates (OKX, Kraken Futures, dYdX), per-venue
  annualized, plus spread_annualized_pp as a ready-made arbitrage signal.
- GET https://defi-signals.org/defi/yields?chain=Base&min_tvl_usd=1000000 — $0.01
  Top DeFi yields from DefiLlama, TVL-filtered, outlier-cleaned (max_apy_pct
  cap, default 300), includes apy_base_pct (base yield without rewards).

## How to pay

Request any endpoint without payment to receive HTTP 402 with a base64
PAYMENT-REQUIRED header (x402 v2). Sign the USDC transferWithAuthorization
per the payment requirements and retry with the PAYMENT-SIGNATURE header.
Compatible with @x402/fetch and any x402 v2 client.

## MCP server

The same tools are available via MCP (Streamable HTTP, stateless):
POST https://defi-signals.org/mcp
Tools: list_pricing (free), get_market_snapshot ($0.002),
get_funding_rates ($0.005), get_top_yields ($0.01).
Payment via x402 in tool-call _meta — compatible with @x402/mcp clients.

Contact: paulos@voiceagenten.com