API Reference

Base URL

API Base URL

https://wdk-api.tether.io

All requests require a valid API key in the x-api-key header:

Authentication Header

x-api-key: your-api-key-here

Don't have an API key yet? Request one by following the steps in our Get Started guide.

Endpoint	Limit
`GET /api/v1/health`	10 req / 1 hour
`GET /api/v1/chains`	60 req / 1 min
`GET /api/v1/:blockchain/:token/:address/token-balances`	4 req / 10s
`GET /api/v1/:blockchain/:token/:address/token-transfers`	8 req / 10s
`POST /api/v1/batch/token-transfers`	8 req / 10s
`POST /api/v1/batch/token-balances`	4 req / 10s

Check API server status

Get list of supported chains and tokens

Get token transfer history for an address

Get current token balance for an address

Get batch token transfers for multiple addresses

Get batch token balances for multiple addresses

The API returns standard HTTP error codes:

Status Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
404	Not Found - Resource not found
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

{
  "error": "error_type",
  "message": "Detailed error message"
}