Skip to main content
Skopos exposes 8 of its own data reads as paid endpoints, priced in USDC via the x402 protocol. Any agent with an x402-capable wallet can pay per call — no signup, no API key, no subscription. This is the opposite direction from the API in API Overview: there, you call Skopos for free. Here, your agent pays Skopos a few cents for a specific data read.

​
Routes

RoutePriceWhat it returns
POST /api/price$0.01Live spot price for a token
POST /api/quote$0.02A swap/bridge route summary + a sign-in link (never raw calldata)
POST /api/risk$0.02Token safety scan — liquidity, honeypot flags, risk score
POST /api/smart-money$0.05Nansen smart-money read for a token
POST /api/yield$0.01Top yield pools for a token
POST /api/polymarket$0.01Top prediction markets
POST /api/market-read$0.01An Aeon market-intelligence read (defi/narrative/trending/etc)
POST /api/treasury$0.01A curated DAO treasury balance lookup
Each route reuses the exact same underlying function its free, chat-facing equivalent calls — there’s one implementation of “get a price” or “scan a token,” not two that can drift apart.

​
Why /api/quote never returns calldata

Every execution path in Skopos is non-custodial — an agent calling this endpoint gets a route summary and a link back to the Skopos app to actually sign, never a directly-executable payload. An agent can’t use this endpoint to move funds on a user’s behalf; it can only use it to research a route.

​
Discovery

  • /openapi.json — machine-readable schema for all 8 routes.
  • /llms.txt — a plain-text summary for LLM agents discovering what Skopos offers.

​
Payment

Standard x402: your agent’s wallet needs to speak the x402 payment protocol (USDC on Base). Point an x402-aware HTTP client at any route above; it will receive a 402 challenge, pay, and get the data back in the same request/response cycle.