Skip to main content

​
Base URL

All API endpoints are served from: 
https://ordsbot.com/api

​
Authentication

Include your session token in the Authorization header: 
Authorization: Bearer <token>
Get a token via the Auth endpoints (wallet challenge/verify flow).

​
Response Format

All responses are JSON. Errors follow this shape: 
{
  "error": "Description of what went wrong",
  "details": ["optional array of validation errors"]
}

​
Status Codes

CodeMeaning
200Success
400Bad request / validation error
401Not authenticated
403Forbidden (plan limit, whitelist, or admin required)
404Resource not found
409Conflict (e.g. duplicate task)
429Rate limited
500Server error

​
Rate Limits

The OrdsBot API itself has no rate limit on authenticated requests. However, all task workers and floor price lookups are subject to Satflow’s API limits (5 req/s, 10 burst, 100k/month per key).