---
agentTools:
  projectIndex: https://tokensniffer.readme.io/llms.txt
---

# API Response

# Status Codes

| Status Code |        Message        |                                                                                                                                       Description |
| :---------- | :-------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------: |
| 200         |           OK          |                                                                                                               Request was fulfilled successfully. |
| 400         |      Bad request      |                                                                                   The request was rejected due to a missing or invalid parameter. |
| 401         |      Unauthorized     |                                                                                                                    API key is missing or expired. |
| 403         |   Permission denied   |                                                                                API key does not have permission to access the requested resource. |
| 404         |       Not found       |           Resource not found.  If this status code is returned for a "Get Token" request on a new token then retry the request after 1-2 minutes. |
| 405         |   Method not allowed  |                                                                                                              An unsupported method was specified. |
| 429         |  Rate limit exceeded  | Request limit for given API key was exceeded.  See [Rate Limit](https://tokensniffer.readme.io/reference/pricing#rate-limit) for further details. |
| 500         | Internal server error |                                                                                              An internal error occurred, please contract support. |

# Response Times

| Endpoint                                                                                                                                                                                                                                        | Typical Response Time (s) |
| :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :-----------------------: |
| **Get Token**                                                                                                                                                                                                                                   |                           |
| \* default (token info and scam status)                                                                                                                                                                                                         |         0.1 - 0.4         |
| \* including score, metrics, and test results (`include_metrics=true` and/or `include_tests=true`) with token info and scam status.  Response time is slower (2-5 seconds) if results need to be refreshed which can happen every 5-30 minutes. |          0.1 - 5          |
| **Get Address**                                                                                                                                                                                                                                 |          0.1 - 1          |
| **List Malicious Tokens**                                                                                                                                                                                                                       |           2 - 5           |
| **List Malicious Addresses**                                                                                                                                                                                                                    |           2 - 5           |