API Environments
Connect to Bond's Spot and Futures APIs using the appropriate base URLs.
Production: REST APIs
Spot API
https://api.bond.xyz
Futures API
https://fapi.bond.xyz
Production: WebSocket
Spot WS
wss://stream.bond.xyz/ws
Spot Stream
wss://stream.bond.xyz/stream
Futures WS
wss://fstream.bond.xyz/ws
Futures Stream
wss://fstream.bond.xyz/stream
Endpoint Structure
Spot API Endpoints
Pattern
https://api.bond.xyz/api/v1/{endpoint}
GET /api/v1/ping
Test connectivity
GET /api/v1/time
Get server time
GET /api/v1/exchangeInfo
Exchange information
GET /api/v1/ticker/24hr
24hr ticker
POST /api/v1/order
Place new order
Futures API Endpoints
Pattern
https://fapi.bond.xyz/fapi/v1/{endpoint}
GET /fapi/v1/ping
Test connectivity
GET /fapi/v1/time
Get server time
GET /fapi/v1/exchangeInfo
Exchange information
GET /fapi/v1/ticker/24hr
24hr ticker
POST /fapi/v1/order
Place new order
API Response Format
Format
JSON
Data order
Chronological unless noted otherwise
Timestamps
Milliseconds by default
Microseconds
Add X-MBX-TIME-UNIT: MICROSECOND header
Timeout
10-second processing timeout
Request Requirements
GET endpoints
Parameters as query string
POST/PUT/DELETE
Query string, request body (x-www-form-urlencoded), or both
Parameter order
May be sent in any order
Duplicate params
Query string parameter takes precedence over body
Authentication
X-MBX-APIKEY header + signature for SIGNED endpoints
Timestamp Behavior
No startTime or endTime
Returns most recent items up to the limit
With startTime only
Returns oldest items from startTime
With endTime only
Returns most recent items up to endTime
With both
Items from startTime, not exceeding endTime
Environment Configuration Example
import os class Config: # Base URLs SPOT_BASE = "https://api.bond.xyz" FUTURES_BASE = "https://fapi.bond.xyz" # WebSocket URLs SPOT_WS = "wss://stream.bond.xyz/ws" FUTURES_WS = "wss://fstream.bond.xyz/ws" # API credentials API_KEY = os.getenv('BOND_API_KEY') SECRET_KEY = os.getenv('BOND_SECRET_KEY')