{ "email": "you@example.com", "password": "yourpassword" }

// Response:
{ "token": "eyJhbGci..." }  ← use this as Bearer token on every request

Replace {currency} with e.g. BNB, WBESC, ETH

// Response — address field contains chain → address map:
{
  "currency": "BNB",
  "balance": 0,
  "address": {
    "BSC": { "address": "0xYourDepositAddress..." }
  }
}

Send funds to address.BSC.address (or whichever chain you use). The deposit is auto-detected and credited to your balance within ~60 seconds.

// Poll every 15s until you see your deposit with status COMPLETED:
{
  "data": [{
    "type": "DEPOSIT",
    "status": "COMPLETED",   ← credit confirmed
    "amount": 0.5,
    "trxId": "0xabc123...",  ← on-chain tx hash
    "wallet": { "currency": "BNB" }
  }]
}

// Or just re-check wallet balance:
GET /api/finance/wallet/ECO/{currency}   → balance field updates on credit

// Returns all trading pairs:
[{ "currency": "WBESC", "pair": "BNB", "symbol": "WBESC/BNB", "metadata": { "taker": 0.1, "maker": 0.1 } }]

// Get live orderbook for a specific pair:
GET /api/ecosystem/market/{symbol}   e.g. /api/ecosystem/market/WBESC%2FBNB
→ { "bids": [[price, qty], ...], "asks": [[price, qty], ...] }

// Limit buy: buy 10 WBESC at 0.0007 BNB each
{
  "currency": "WBESC",   ← base asset
  "pair": "BNB",         ← quote asset (what you pay/receive)
  "type": "limit",       ← "limit" or "market"
  "side": "BUY",         ← "BUY" or "SELL"
  "amount": 10,          ← qty of base asset (WBESC)
  "price": 0.0007        ← omit for market orders
}

// Response:
{ "order": { "id": "uuid", "status": "OPEN", "side": "BUY", "amount": 10, "price": 0.0007 } }

// Market sell: sell 10 WBESC at best available price
{ "currency": "WBESC", "pair": "BNB", "type": "market", "side": "SELL", "amount": 10 }

// List your open orders:
GET /api/ecosystem/order
→ [{ "id": "uuid", "status": "OPEN"|"FILLED"|"PARTIALLY_FILLED"|"CANCELLED", "filled": 10 }]

// Cancel a specific order:
DELETE /api/ecosystem/order/{orderId}

// Cancel ALL open orders:
DELETE /api/ecosystem/order/all

{
  "currency": "BNB",                        ← currency to withdraw
  "chain": "BSC",                           ← network (BSC, ETH, BESC, etc.)
  "amount": 0.42,                           ← amount (network fee deducted automatically)
  "toAddress": "0xYourExternalWallet..."    ← destination address
}

// Response:
{ "message": "Withdrawal processed successfully" }

// Check withdrawal status:
GET /api/finance/transaction?walletType=ECO&currency=BNB&type=WITHDRAW&sortOrder=desc
→ status: PENDING → PROCESSING → COMPLETED

Withdrawals are processed automatically. Network fees are estimated and deducted from the amount. No minimum withdrawal (fees must be covered).