Rate Limits & Caching
Cache TTLs
All data is cached in-process using moka LRU caches. No external Redis at the API layer.
| Cache | TTL | Max Entries | Key Pattern |
|---|---|---|---|
| Wallet performance | 30s | 10,000 | perf:{address}:{days} |
| Leaderboard | 60s | 50 | lb:{days}:{sort}:{limit}:{offset} |
| Token info | 300s | 50,000 | token_info:{mint} |
| OHLCV | 5s | 5,000 | ohlcv:{mint}:{view}:{from}:{to}:{limit}:{tf} |
| Wallet labels | 60s | 10,000 | labels:{address} |
Pagination Limits
| Endpoint | Default Limit | Max Limit |
|---|---|---|
| /v1/wallets/:addr/trades | 50 | 200 |
| /v1/wallets/:addr/positions | 100 | 100 (fixed) |
| /v1/leaderboard | 100 | 500 |
| /v1/tokens/:mint/ohlcv | 500 | 2000 |
| /v1/tokens/:mint/trades | 50 | 200 |
WebSocket Limits
| Limit | Value |
|---|---|
| Max subscriptions per connection | 50 |
| Per-client message buffer | 256 messages |
| Server ping interval | 30s |