API Reference

Rate Limits and Conventions

HTTP Status Codes

  • 200 OK: Successful request.
  • 400 Bad Request: Missing or invalid request parameters.
  • 401 Unauthorized: Invalid credentials or missing token.
  • 403 Forbidden: Unauthorized access to endpoints.
  • 429 Too Many Requests: Rate limit exceeded.

Rate Limits

The TokenTrace API enforces rate limits on different endpoints to ensure fair usage across all users. Rate limiting is based on the IP address of the client.

Rate Limit Policies:

EndpointRate Limit
/api/login20 requests per minute
/api/crypto_scams60 requests per minute

If the rate limit is exceeded, the API will return a 429 Too Many Requests response. You should implement proper handling for this response in your application, such as waiting and retrying after the specified time.

Example Rate-Limit Response:

{
  "error": "Rate limit exceeded. Try again in 60 seconds."
}