Bumba
Log InRegister

API Documentation

REST API and WebSocket documentation for programmatic trading access.

Base URL

https://api-dev.bumba.global/api/v1

Authentication

All authenticated endpoints require an API key and signature. Generate your API credentials from the Settings page.

Required Headers

X-API-KEY: your_api_key

X-API-SIGNATURE: hmac_sha256_signature

X-API-TIMESTAMP: unix_timestamp_ms

Signature Generation

The signature is computed as HMAC-SHA256 of the request body concatenated with the timestamp, using your API secret as the key.

Orders

POST/orders

Place a new order.

{
  "symbol": "BTC-USD",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": "0.1",
  "price": "50000.00"
}
DELETE/orders/:orderId

Cancel an existing order.

GET/orders

Get all open orders for your account.

Markets

GET/markets

List all available trading pairs.

GET/markets/:symbol/orderbook

Get the current order book for a symbol.

GET/markets/:symbol/candles

Get OHLCV candle data for charting.

Query params: interval (1m, 5m, 15m, 1h, 4h, 1d), limit, start, end

Account

GET/account/balances

Get all asset balances for your account.

GET/account/trades

Get trade history for your account.

WebSocket

Real-time market data and order updates via WebSocket.

Connection URL

wss://ws-dev.bumba.global

Available Channels

  • orderbook.{symbol} - Real-time order book updates
  • trades.{symbol} - Real-time trade stream
  • ticker.{symbol} - Price ticker updates
  • user.orders - Your order updates (authenticated)
Back to Home