Providers
| Provider | Base Path | Testnet |
|---|
| Hyperliquid | /v1/spot/hyperliquid/ | Yes |
| Aster DEX | /v1/spot/aster/ | Yes |
Endpoints
Market Data (Read)
| Method | Path | Description |
|---|
GET | /spot/:provider/markets | List all spot markets |
GET | /spot/:provider/markets/:symbol | Get a single market |
GET | /spot/:provider/orderbook/:symbol | Get orderbook |
GET | /spot/:provider/trades/:symbol | Get recent trades |
GET | /spot/:provider/candles/:symbol | Get historical candles |
GET | /spot/:provider/ticker/:symbol | Get 24h ticker |
GET | /spot/:provider/prices | Get all mid prices |
Account (Read)
| Method | Path | Description |
|---|
GET | /spot/:provider/balances/:address | Get spot balances |
GET | /spot/:provider/orders/:address | Get open orders |
GET | /spot/:provider/fills/:address | Get recent fills |
Trading (Write)
| Method | Path | Description |
|---|
POST | /spot/:provider/orders | Place a new order |
DELETE | /spot/:provider/orders/:orderId | Cancel an order |
POST | /spot/:provider/transfer | Transfer between spot and perp wallets |
Spot symbols use a pair format (e.g., PURR/USDC on Hyperliquid). Check the markets endpoint for available pairs.
Provider Comparison
| Feature | Hyperliquid | Aster |
|---|
| Markets | 50+ spot pairs | 80+ spot pairs |
| Order Types | limit, market | limit, market |
| Spot/Perp Transfer | Yes | Yes |
WebSocket Channels
Real-time data via wss://api.perps.studio/ws/v1/spot:
| Channel | Params | Description |
|---|
orderbook | symbol | Level 2 book updates |
trades | symbol | Trade executions |
ticker | symbol | 24h stats |
