REST API Reference
Base URL: https://api.waretto.com
GET
/v1/quotes/{symbol}Get the latest quote for a single symbol.
| Param | Type | Description |
|---|---|---|
symbol | string | Path — e.g. BTC-USD, EUR-USD, AAPL |
POST
/v1/quotes/batchGet quotes for multiple symbols in one request.
| Param | Type | Description |
|---|---|---|
symbols | string[] | Body — ["BTC-USD", "ETH-USD"]. Max per plan. |
GET
/v1/history/{symbol}Get OHLC historical bars.
| Param | Type | Description |
|---|---|---|
interval | string | 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w (default: 1d) |
from | int | Unix timestamp (seconds) |
to | int | Unix timestamp (default: now) |
limit | int | 1–5000 (default: 200) |
GET
/v1/searchSearch supported symbols by ticker or name.
| Param | Type | Description |
|---|---|---|
q | string | Search query (required, min 1 char) |
type | string | CRYPTO, EQUITY, ETF, FX, COMMOD |
limit | int | 1–50 (default: 10) |
GET
/v1/snapshotLatest quotes for all tracked symbols.
Example Response
{
"status": "ok",
"symbol": "BTC/USD",
"data": {
"price": 67432.80,
"bid": 67432.10,
"ask": 67433.50,
"volume_24h": 28540.5,
"asset_type": "CRYPTO",
"source": "binance"
},
"request_id": "a1b2c3d4"
}Rate Limit Headers
| Header | Description |
|---|---|
X-RateLimit-Limit-Minute | Your plan's per-minute limit |
X-RateLimit-Remaining-Minute | Requests remaining this minute |
X-RateLimit-Limit-Day | Your plan's daily limit |
X-RateLimit-Remaining-Day | Requests remaining today |
X-RateLimit-Reset | Unix timestamp when the minute window resets |
Error Codes
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No API key provided |
| 401 | invalid_api_key | Key not found or expired |
| 404 | symbol_not_found | Symbol not tracked |
| 429 | rate_limit_exceeded | Plan rate limit hit |
| 400 | batch_limit_exceeded | Too many symbols in batch |