REST API
API v3 is Now Available
We've introduced API v3 with API key authentication. API v1 and v2 are being deprecated and will eventually require API keys as well.
Important: Starting Q2 2026, the REST API will require a valid API key. Requests without an API key will be subject to gradually increasing error responses. As of Q4 2026, all requests will require a valid API key.
Quick Start
- Get an API Key - Register for a free API key from Geomi
- Read the Announcement - Learn about the changes
- Migrate to v3 - Step-by-step migration guide
API Key Authentication
Include your API key in the request header using the X-API-Key header:
X-API-Key: YOUR_API_KEY
Example with curl:
curl -H "X-API-Key: YOUR_API_KEY" \
https://www.aptosnames.com/api/mainnet/v3/address/test