Skip to main content

Guides

Practical guides for common OneSource REST API workflows.

Available​

  • Batching and cost optimization: patterns that cut API spend 5-20x: batched balance calls, endpoint-tier awareness, client-side caching, and amortized settlement (MPP sessions or x402 batch settlement) for high-volume workloads.
  • Error codes: the two error shapes (envelope from OneSource, flat from the gateway), what each HTTP status means, and a recovery pattern that handles both. Includes a normalizer and a retry/backoff sketch.
  • Migrating from x402 / MPP to an API key: moving production traffic from wallet-paid x402 or MPP calls to a Bearer API key from app.onesource.io (or running both in parallel). Generalized across our discovery channels: AgenticMarket / CDP Bazaar, AgentCash, x402scan, mppScan, MCP Registry, Glama, npm.
  • AI editor setup: wire the OneSource docs into Claude Code, Claude Desktop, Cursor, VS Code, or Windsurf as an MCP server so your assistant can answer questions about the API. Distinct from @one-source/mcp, which lets the assistant call the API.

Reference​

The API Reference lists every endpoint with parameters, example responses, and per-call pricing.