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
dataandrequest_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 withGET /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 returnpagination with page, limit (max 25), total, and absolute next_page / prev_page URLs. Follow next_page until it is null.
Connect over MCP instead
Machine-readable docs
- OpenAPI spec:
/openapi.yaml - Docs index for LLMs:
/llms.txt· full docs in one file:/llms-full.txt - Every page has a raw markdown twin: append
.mdto its URL.