Spot API
All private endpoints require a signed request. Read the Authentication Guide before making your first call. Public endpoints (market data, orderbook) need no credentials.
Environmentβ
| Product | Production | Testnet |
|---|---|---|
| Spot REST | https://api.btse.com/spot | https://testapi.btse.io/spot |
| Spot WebSocket | wss://ws.btse.com/ws/spot | wss://testws.btse.io/ws/spot |
| Spot OSS | wss://ws.btse.com/ws/oss/spot | wss://testws.btse.io/ws/oss/spot |
The OSS (Order Stream Service) endpoint is used exclusively for Orderbook Incremental Updates.
Public market data (orderbook, ticker, OHLCV, etc.) is now served by the Markets API.
Rate Limitsβ
| Category | Per API | Per User |
|---|---|---|
| Query | 15 req/s | 30 req/s |
| Orders | 75 req/s | 75 req/s |
Exceeding limits triggers a tiered block: 1 second β 5 minutes β 15 minutes. A Retry-After header is included in all 429 responses. See Rate Limits for the full mechanism.
Discovering Tradeable Pairsβ
Call Markets Information (no auth required) to get all available markets:
curl https://api.btse.com/public-api/market/v1/markets
Each entry includes the symbol name and trading constraints:
| Field | Use |
|---|---|
symbol | The market identifier to use in all API calls (e.g. BTC-USDT) |
active | true if the market is currently open for trading |
baseCurrency / quoteCurrency | The two currencies in the pair |
minOrderSize / maxOrderSize | Size limits for orders |
minPriceIncrement | Tick size β your price must be a multiple of this |
minSizeIncrement | Lot size β your quantity must be a multiple of this |
Symbol naming conventionsβ
| Product | Format | Example |
|---|---|---|
| Spot | BASE-QUOTE | BTC-USD, ETH-USDT |
| Futures (v2.3) | BASE-PERP | BTC-PERP, ETH-PERP |
| Futures (legacy) | Concatenated | BTCPFC (use ApplyNewSymbolName: Y in FIX to get new names) |
For crypto assets with very small prices, market data uses a K/M/B prefix (e.g. K_PEIPEI), but wallet APIs always use the original name without prefix (matching the base field).
API Status Codesβ
See the shared Error Codes reference for HTTP status codes and internal API enum values.
API Enumβ
Order status codes, order type codes, and other numeric enums are documented in Error Codes β API Status Enum.