Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.shuriken.trade/llms.txt

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

Every error response from the Shuriken API follows a consistent envelope so you can handle failures predictably across all endpoints.

​
Error format

{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Amount must be a positive integer string",
    "details": null
  },
  "requestId": "req_abc123"
}
FieldDescription
error.codeMachine-readable error code
error.messageHuman-readable explanation
error.detailsOptional additional context (may be null)
requestIdUnique request identifier for debugging
Always include the requestId when contacting support. It lets us trace exactly what happened.

​
Common error codes

HTTP StatusCodeTypical cause
400INVALID_PARAMSMissing or invalid parameters
400NO_ROUTENo swap route found for the given token pair
401UNAUTHORIZEDMissing, invalid, or expired API key
403FORBIDDENKey lacks the required permission scope
404NOT_FOUNDResource does not exist (token, order, etc.)
429RATE_LIMITEDToo many requests - slow down
500INTERNAL_ERRORSomething went wrong on our end

​
Rate limiting

When you exceed your rate limit, the API returns a 429 response. Check your current usage and limits at any time: 
curl -X GET "https://api.shuriken.trade/api/v2/account/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Handling errors

Build resilient integrations by checking the HTTP status code and error.code field:
Python
response = requests.post(
    "https://api.shuriken.trade/api/v2/swap/execute",
    headers=headers,
    json=payload,
)

if response.status_code != 200:
    error = response.json()
    code = error["error"]["code"]

    if code == "NO_ROUTE":
        # Try a different token pair or adjust amount
        pass
    elif code == "RATE_LIMITED":
        # Back off and retry
        pass
    else:
        print(f"Error {code}: {error['error']['message']}")