Plans
Pay in USDA from your Auralis wallet, monthly or yearly. Your plan switches on by itself when the payment arrives.
Your API key
Send the key in the X-API-Key header with every request.
1. Get a free key
Free keys can use the price endpoints. Upgrade for everything else.
2. Check your plan or upgrade
Documentation
Everything lives under /api/v1. Responses are JSON, and every call allows cross-origin requests from the browser.
Price history and charts
Get a token's price over time as ready-to-plot points. Use it for charts, bots, dashboards and alerts. GET /price-history/{token}?range=1D takes a token id or symbol.
This is live data from the API, drawn with the code below. Ranges marked Developer need a key on a paid plan.
| range | Covers | Plan |
|---|---|---|
| 1D | Last 24 hours (default) | Free |
| 1W | Last 7 days | Free |
| 1M | Last 30 days | Developer |
| 3M | Last 90 days | Developer |
| 1Y | Last 365 days | Developer |
| ALL | Everything recorded | Developer |
Response
timeis a Unix timestamp in seconds (UTC), oldest point first. A call returns up to 300 points.change_pctis the change from the first to the last point of the range.- A point is saved whenever the price changes, and at least every 5 minutes. After 7 days, older points are thinned to one per hour.
- A token's history starts when it first got a price, so new tokens have short charts. A token with no price returns 404.
Endpoints
| Method | Path | Plan | What it returns |
|---|---|---|---|
| Loading... | |||
Limits
Each key has a limit per minute and per day (the day resets at 00:00 UTC). Every response tells you where you stand:
Errors
| Status | Meaning |
|---|---|
| 401 | The key is missing, wrong or revoked. |
| 403 | Your plan does not include this endpoint. Upgrade above. |
| 404 | Nothing found, for example an unknown token or transaction. |
| 429 | You hit your per-minute or per-day limit. Wait for the time in the Retry-After header. |
Upgrading to a higher plan starts a fresh period. Paying for the same plan again adds the period you pay for. Payments are not refundable.