Developers · Execution Engine

Build on the Boss Traders Flow API.

REST for accounts and orders, WebSocket for real-time streams, and FIX 4.4 for institutional order flow — all backed by the same matching engine and unified margin account.

Create API Key Execution Engine

REST rate limit

1,200 req / min per IP

WebSocket

300 subscriptions per connection

FIX order rate

100 msgs / s per session

Key permissions

Read · Trade · Withdraw + IP whitelist

Market data

Public, unauthenticated market data for all 10 USDT pairs.

GET
/api/market/tickers
24h ticker, market cap, sparkline and best bid/ask for every pair.
Public
GET
/api/market/klines
OHLCV candles.
symbol=BTC&interval=1m|5m|15m|1h|4h|1d|1w&limit=300
Public
GET
/api/market/depth
Order book snapshot (bids/asks).
symbol=BTC&limit=20
Public
GET
/api/market/trades
Most recent public trades.
symbol=BTC&limit=50
Public
GET
/api/market/funding
Current perpetual funding rates and next funding time.
Public
GET
/api/market/funding-history
Historical funding for one market.
symbol=BTC
Public
GET
/api/market/sentiment
Fear & Greed index with 30-day history.
Public

Trading

Place, list and cancel orders. All 9 order types are supported.

POST
/api/orders
Place an order (MARKET, LIMIT, STOP_LIMIT, ICEBERG, TWAP, VWAP, POST_ONLY, TRAILING_STOP, OCO).
JSON body — see example
Auth
GET
/api/orders
List orders.
scope=open|history&symbol=BTC
Auth
DELETE
/api/orders
Cancel all open orders, optionally for one market.
symbol=BTC
Auth
DELETE
/api/orders/{id}
Cancel a single order.
Auth
GET
/api/trades
Your fills with fees and liquidity flag.
symbol=BTC
Auth

Boss Traders AI signals

Simulated demo trade signals (entry, stop-loss, TP1–TP3, confidence) with a replayed win/loss track record. Not financial advice.

GET
/api/signals
Active signals, closed-signal history and the aggregated track record.
symbol=BTC&status=all|active|history&limit=40
Public
GET
/api/signals/{id}
One signal with the per-market track record.
Public
POST
/api/signals/{id}/follow
Follow a signal: balance, price-range and post-trade margin checks, then a MARKET entry plus optional TP1/stop-loss OCO bracket. dryRun returns the checks only.
{ usdAmount | quantity, bracket?: true, dryRun?: false }
Auth

AI trading agents

Goal-driven demo agents that decide BUY, SELL or HOLD and trade through the Execution Engine inside platform-enforced guardrails. Every run is journaled. Not financial advice.

GET
/api/agents
Your agents with stats, pending proposals, recent decisions and a summary.
Auth
POST
/api/agents
Create an agent (max 5 per account).
{ name, goal, model, mode: APPROVE|AUTO, riskProfile, symbols[], budgetUsd, maxOrderUsd, maxTradesPerDay, dailyLossLimitUsd, maxMarginUtilPct, stopLossPct, takeProfitPct, intervalMin, useSignals }
Auth
GET
/api/agents/{id}
One agent with its stats and decision history.
Auth
PATCH
/api/agents/{id}
Update settings, or pause / resume the agent.
{ ...any create fields, status?: ACTIVE|PAUSED }
Auth
DELETE
/api/agents/{id}
Delete an agent. Its executed orders stay in your order history.
Auth
POST
/api/agents/{id}/run
Run the agent now: market context → AI decision → guardrail checks → proposal or execution.
Auth
POST
/api/agents/tick
Run every active agent that is due and return the next scheduled run time.
Auth
POST
/api/agents/pause-all
Kill switch: pause every agent and expire all pending proposals.
Auth
POST
/api/agents/decisions/{id}
Approve or reject a pending proposal. Guardrails are re-checked on approval; a blocked trade returns 422.
{ action: approve|reject }
Auth

Unified margin

Cross-asset collateral, risk offsetting and cross-margin positions.

GET
/api/margin
Collateral basket, netted margin requirements, liquidation prices and health.
Auth
GET
/api/positions
Open and recently closed positions.
Auth
POST
/api/positions
Open a cross-margin position.
{ symbol, side: LONG|SHORT, size, leverage }
Auth
DELETE
/api/positions/{id}
Close a position at mark and realize PnL.
Auth

Wallet & account

Balances, transfers, conversion and account settings.

GET
/api/portfolio
Balances with valuations, cost basis, PnL and allocation.
history=1
Auth
POST
/api/convert
Instant conversion between any two assets.
{ from, to, amount, quoteOnly? }
Auth
POST
/api/deposit
Credit a deposit (demo accounts are simulated).
{ asset, amount, network, method }
Auth
POST
/api/withdraw
Request a withdrawal (2FA code required when enabled).
{ asset, amount, network, address, twoFactorCode }
Auth
GET
/api/transactions
Deposits, withdrawals and conversions.
type=DEPOSIT|WITHDRAWAL|CONVERT
Auth
GET
/api/alerts
Your price alerts.
Auth
POST
/api/alerts
Create a price alert.
{ symbol, condition: ABOVE|BELOW, targetPrice }
Auth
GET
/api/notifications
Account notifications.
Auth
GET
/api/profile
Profile, VIP tier, 30-day volume and security score.
Auth
POST
/api/api-keys
Create an API key with permissions and IP whitelist.
{ label, permissions[], ipWhitelist }
Auth

Authentication

Browser sessions use a secure session cookie. Programmatic clients sign requests with an API key created in Profile → API keys, sending X-BTF-APIKEY, X-BTF-TIMESTAMP and an HMAC-SHA256 X-BTF-SIGNATURE of the request.

Place an iceberg order

curl -X POST https://<your-domain>/api/orders \
  -H "Content-Type: application/json" \
  -H "Cookie: <session cookie>" \
  -d '{
    "symbol": "BTC",
    "side": "BUY",
    "type": "ICEBERG",
    "quantity": 2.5,
    "price": 64250.00,
    "visibleQty": 0.25,
    "timeInForce": "GTC"
  }'

Response

{
  "order": {
    "id": "clx9f2k0q0001",
    "symbol": "BTC",
    "side": "BUY",
    "type": "ICEBERG",
    "status": "OPEN",
    "price": 64250,
    "quantity": 2.5,
    "visibleQty": 0.25,
    "filledQty": 0,
    "routing": [
      { "venue": "BTF Core Book", "pct": 100, "latencyMs": 0.52, "improvementBps": 0 }
    ],
    "createdAt": "2026-09-25T14:03:11.402Z"
  }
}

Public depth snapshot

curl "https://<your-domain>/api/market/depth?symbol=ETH&limit=5"

{
  "bids": [{ "price": 3421.18, "qty": 12.4 }, ...],
  "asks": [{ "price": 3421.19, "qty": 8.91 }, ...],
  "source": "binance",
  "ts": 1790345000000
}

Follow a Boss Traders AI signal

curl -X POST https://<your-domain>/api/signals/BTC-1790000000000/follow \
  -H "Content-Type: application/json" \
  -H "Cookie: <session cookie>" \
  -d '{ "usdAmount": 500, "bracket": true, "dryRun": true }'

# dryRun: true  -> { "preview": { "checks": [...], "canExecute": true, ... } }
# dryRun: false -> { "entry": {...}, "bracket": [...], "message": "Signal followed ..." }