# Usenami

> Real-time multi-venue perpetual futures market data — funding rates, orderbook depth, oracle families, RWA coverage. Built for arb-aware AI agents.

## Service
- Base URL: https://api.usenami.io
- Payment: x402 protocol, Base mainnet (eip155:8453), USDC
- Discovery JSON: https://api.usenami.io/openapi.json, https://api.usenami.io/.well-known/x402.json
- Bazaar listing: https://agentic.market/services/api-usenami-io
- Provider: https://usenami.io

## Contact
- Report issues / request data: support@usenami.io
- Partnerships / business: business@usenami.io
- Telegram: https://t.me/USnami

## Paid endpoints
- GET /v1/backtest/data ($0.05) — required: venue, ticker, from, to
- GET /v1/funding/current ($0.001)
- GET /v1/funding/historical ($0.005) — required: ticker
- GET /v1/orderbook/aggregate/{symbol} ($0.002)
- GET /v1/orderbook/best-execution ($0.010) — required: ticker
- GET /v1/orderbook/depth/{venue}/{symbol} ($0.002)
- GET /v1/orderbook/multi-venue-execution ($0.010) — required: ticker
- GET /v1/orderbook/multi-venue-slippage ($0.005) — required: ticker
- GET /v1/orderbook/{venue}/{symbol}/top ($0.001)
- GET /v1/perp/arbitrage/funding ($0.003)
- GET /v1/perp/arbitrage/funding-signal ($0.005)
- GET /v1/perp/arbitrage/price ($0.003)
- GET /v1/perp/basis ($0.005) — required: ticker
- GET /v1/perp/carry ($0.005) — required: ticker
- GET /v1/perp/funding-flips ($0.003) — required: ticker
- GET /v1/perp/funding-next ($0.003) — required: ticker, venue
- GET /v1/perp/funding-spread ($0.001) — required: ticker
- GET /v1/perp/oi-delta ($0.003) — required: ticker, venue
- GET /v1/perp/oi-history ($0.005) — required: ticker, venue
- GET /v1/perp/open-interest ($0.001) — required: venue, ticker
- GET /v1/perp/oracle-families ($0.001)
- GET /v1/perp/snapshot ($0.005) — required: ticker
- GET /v1/perp/volume-24h ($0.001) — required: venue, ticker
- GET /v1/perp/volume-anomalies ($0.003)
- GET /v1/perp/volume-history ($0.005) — required: ticker, venue
- GET /v1/perp/vw-spread ($0.003) — required: ticker
- GET /v1/rwa/perp-coverage ($0.001)

## Free endpoints
- GET /v1/health (free)
- GET /v1/preview/funding-current (free)
- GET /v1/preview/funding-current/upgrade (free)
- GET /v1/preview/funding-signal (free)
- GET /v1/venues/health (free)
- GET /v1/venues/list (free)
- GET /v1/x402/discovery/resources (free)

## Docs
- Human docs: https://usenami.io/api-docs
- x402 protocol: https://x402.org
- llms.txt convention: https://llmstxt.org