Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.binibit.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Default quotas

TierScopeLimit
PublicAll Spot Market API endpoints60 requests / minute / IP
BurstAll public10 requests / second / IP
Both limits apply simultaneously. Exceeding either returns HTTP 429.

​
Response headers

Every successful response includes:
HeaderMeaning
X-RateLimit-LimitQuota for the current window (e.g. 60).
X-RateLimit-RemainingRequests left in the current window.
X-RateLimit-ResetUnix timestamp (ms) when the window resets.
Example: 
HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1777399720000

​
When you exceed the limit

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{
  "code": "RATE_LIMIT",
  "message": "Rate limit exceeded. Retry after 12 seconds."
}
The Retry-After header tells you how many seconds to wait before retrying.

​
Best practices

1

Cache aggressively

/tickers is updated every few seconds. Cache for at least 5 seconds on your side instead of polling continuously.
2

Respect Retry-After

Always honor the Retry-After header on 429. Do not retry immediately.
3

Use exponential backoff

On repeated 429 or 5xx, back off exponentially with jitter.
4

Batch where possible

Use /tickers (returns all pairs) instead of polling each pair individually.

​
Elevated limits

Aggregators, market makers, and high-volume consumers can request:
  • Higher per-IP quotas
  • Static IP whitelisting (no rate limit)
  • Dedicated read replicas
Contact api@binibit.com with:
  • Use case description
  • Estimated request volume
  • Source IP range or CIDR