Account Endpoints

Query account information, order status, and trade history. All endpoints require HMAC-SHA256 signature (SecurityType: UserData).

Binance API Reference: Spot Account/Trade

Account Information

Get current account information including balances and permissions.

val account: F[AccountInfo] = client.accountInfo

Endpoint	GET /api/v3/account
Auth	HMAC Signed
Weight	20

Key response fields:

case class AccountInfo(
  canTrade: Boolean,
  canWithdraw: Boolean,
  canDeposit: Boolean,
  accountType: String,
  balances: List[Balance],  // Balance(asset, free, locked)
  // ...
)

Query Order

Check the status of an order.

val order: F[OrderInfo] = client.orderStatus("BTCUSDT", orderId = Some(12345L))

Endpoint	GET /api/v3/order
Auth	HMAC Signed
Weight	4

Open Orders

Get all open orders on a symbol or all symbols.

// Single symbol
val open: F[List[OrderInfo]] = client.openOrders(Some("BTCUSDT"))

// All symbols
val allOpen: F[List[OrderInfo]] = client.openOrders()

Endpoint	GET /api/v3/openOrders
Auth	HMAC Signed
Weight	6 (single) / 80 (all)

All Orders

Get all orders (active, canceled, filled) for a symbol.

val orders: F[List[OrderInfo]] = client.allOrders("BTCUSDT", limit = Some(100))

Endpoint	GET /api/v3/allOrders
Auth	HMAC Signed
Weight	20

My Trades

Get the account's trade history for a symbol.

val trades: F[List[MyTrade]] = client.myTrades("BTCUSDT", limit = Some(50))

Endpoint	GET /api/v3/myTrades
Auth	HMAC Signed
Weight	20

Order Rate Limit

Get the current unfilled order count for each rate limit interval.

val limits: F[List[RateLimitOrder]] = client.rateLimitOrder

Endpoint	GET /api/v3/rateLimit/order
Auth	HMAC Signed
Weight	40

Order List Status

Check the status of an OCO or order list.

import io.github.rafafrdz.binance4s.api.account.OrderListStatusReq

val orderList: F[OrderListResponse] = client.execute(OrderListStatusReq(orderListId = Some(123L)))

Endpoint	GET /api/v3/orderList
Auth	HMAC Signed
Weight	4

All Order Lists

Get all order lists (OCO) for the account.

import io.github.rafafrdz.binance4s.api.account.AllOrderListReq

val lists: F[List[OrderListResponse]] = client.execute(AllOrderListReq(limit = Some(10)))

Endpoint	GET /api/v3/allOrderList
Auth	HMAC Signed
Weight	20

Open Order Lists

Get all open order lists (OCO).

import io.github.rafafrdz.binance4s.api.account.OpenOrderListReq

val open: F[List[OrderListResponse]] = client.execute(OpenOrderListReq())

Endpoint	GET /api/v3/openOrderList
Auth	HMAC Signed
Weight	6

Prevented Matches

Get the list of orders that were prevented from trading due to self-trade prevention.

import io.github.rafafrdz.binance4s.api.account.PreventedMatchesReq

val matches: F[List[PreventedMatch]] = client.execute(PreventedMatchesReq("BTCUSDT"))

Endpoint	GET /api/v3/myPreventedMatches
Auth	HMAC Signed
Weight	20

SOR Allocations

Get the SOR (Smart Order Router) allocation history.

import io.github.rafafrdz.binance4s.api.account.AllocationsReq

val allocs: F[List[SorAllocation]] = client.execute(AllocationsReq("BTCUSDT"))

Endpoint	GET /api/v3/myAllocations
Auth	HMAC Signed
Weight	20

Commission Rates

Get the commission rates for a specific symbol.

val comm: F[Commission] = client.commission("BTCUSDT")

Endpoint	GET /api/v3/account/commission
Auth	HMAC Signed
Weight	20