Skip to main content
Everything an AI agent needs to call the DeFi Orbit API, on one page. For tool-based access, skip the REST API entirely and connect to DeFi Orbit AI over MCP.

The contract

  • Base URL: https://api.defiorbit.xyz. Every route is under /v1.
  • Auth: Authorization: Bearer do_sk_... on every request. The key selects the organization; credits and the rate limit are organization-level.
  • Every success is JSON with data and request_id. Every failure is { "error": { "code", "message", "request_id" } }.
  • Only 2xx responses spend credits. Costs run 1–30 credits per call; each endpoint page in the API Reference states its cost, and Credits has the billing rules.

Retry rules

The rate limit is 5 requests per second per organization by default. X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix seconds) are set on 429.

Protect the credit balance

Before loops or batch work, read the balance with GET /v1/usage/credits (1 credit). List and batch calls multiply a unit cost by result counts — read Credits before writing a loop. Start with summary endpoints (1–3 credits) to decide whether a deeper call is worth it.

Pagination

List endpoints return pagination with page, limit (max 25), total, and absolute next_page / prev_page URLs. Follow next_page until it is null.

Connect over MCP instead

Same key, same credits, same rate limit; 52 read-only tools. The full list is on the tool reference.

Machine-readable docs