External API v1.0

Base URL

https://api.bitria.io/api/v1

• X-API-KEY
  your-api-key
  Public API key
• X-API-TIMESTAMP
  Unix timestamp (ms)
  Anti-replay timestamp
• X-API-SIGNATURE
  HMAC-SHA256 signature
  Request signature

HMAC-SHA256(timestamp + method + path + body, api_secret)

• GET/v1/accounts

  Query account balances

  Parameters

  • tradeType*
    string

    SPOT | FUTURES | MARGIN

  • coin
    string

    Filter by specific coin

  Responses

  200Balance info400Missing tradeType

• POST/v1/orders

  Place an order

  Request body (JSON)

  • symbol*
    string

    Trading pair (e.g. BTC-USDT)

  • side*
    string

    BUY | SELL

  • orderType*
    string

    MARKET | LIMIT

  • tradeType*
    string

    SPOT | FUTURES | MARGIN

  • quantity
    number

    Quantity for MARKET SELL or LIMIT orders

  • price
    number

    Price for LIMIT orders

  • funds
    number

    Order amount in USDT for MARKET BUY

  • leverage
    integer

    Leverage for FUTURES (1–125)

  • marginMode
    string

    CROSS | ISOLATED (FUTURES only)

  Responses

  202Order accepted400Invalid parameters401Authentication failed429Rate limit exceeded
• GET/v1/orders

  List orders

  Parameters

  • symbol
    string

    Filter by trading pair

  • tradeType
    string

    SPOT | FUTURES | MARGIN

  • status
    string

    PENDING | SUBMITTED | FILLED | CANCELLED

  • page
    integer

    Page number (default: 1)

  • limit
    integer

    Items per page (default: 20, max: 100)

  Responses

  200Order list
• GET/v1/orders/{orderId}

  Get order details

  Parameters

  • orderId*
    string

    Order ID

  Responses

  200Order details with fills404Order not found
• POST/v1/orders/{orderId}/cancel

  Cancel an order

  Parameters

  • orderId*
    string

    Order ID

  Responses

  200Cancelled404Order not found409Cannot cancel (already filled)

• GET/v1/fills

  Query fill history

  Parameters

  • symbol
    string

    Filter by trading pair

  • tradeType
    string

    SPOT | FUTURES | MARGIN

  • orderId
    string

    Filter by specific order

  • startTime
    integer

    Start time (unix ms)

  • endTime
    integer

    End time (unix ms)

  • page
    integer

    Page number (default: 1)

  • limit
    integer

    Items per page (default: 20, max: 100)

  Responses

  200Fill history

• GET/v1/positions

  Query open positions

  Parameters

  • tradeType
    string

    FUTURES | MARGIN

  • symbol
    string

    Filter by trading pair

  Responses

  200Open positions