​
Getting an API Key

Please contact [email protected] to request an API key.

​
Connecting to the REST API

Once our team has provisioned an API key, you can start making requests to our REST API over HTTPS. API Key authentication is done via HTTP headers. Example request:

curl -i -H "x-api-key: 875e1017-87b8-4b12-8301-6aa1f1aa073b" \
  --url https://api.saucerswap.finance/tokens

Example response(with response headers):

HTTP/2 200 
date: Thu, 17 Apr 2025 11:03:06 GMT
content-type: application/json; charset=utf-8
content-length: 92697
...
...
x-ratelimit-limit: 10000
x-ratelimit-remaining: 8250
x-ratelimit-additional-total: 0
x-ratelimit-reset: 1746071999999
...
...

[
  {
    "id": "0.0.731861",
    "icon": "/images/tokens/sauce.svg",
    "symbol": "SAUCE",
    "decimals": 6,
    "price": "36806544",
    "priceUsd": 0.01760954,
    "dueDiligenceComplete": true,
    "isFeeOnTransferToken": false
  }
]

​
Understanding Authentication Headers

​
Request Headers

  1. x-api-key You will use this header to pass your API key to our system for validation and authorization with every request. The key is a 32 character string we provision for you.

​
Response Headers

  1. x-ratelimit-limit This response header communicates the total number of requests you can make in a month. This limit is determined by conversations you have with our team at time of provisioning.
  2. x-ratelimit-remaining As you make requests throughout the month this value will go down. You can use this value programmatically to, for example, alert your team of potentially a need for a higher limit or to self-throttle.
  3. x-ratelimit-additional-total There are circumstances where, perhaps, you may need more requests than what was discussed with our team at time of API key provisioning. If you think this might happen on occasion, please bring this up with our team. When that happens, you will see this value increase with each request over the limit.
  4. x-ratelimit-reset This header value represents the time in millisecnods when usage statistics will reset. This typically points to the end of the current month.