Account (HTTP - Unsigned)

Query Account (Unsigned)

Query account information. No signature required - read-only operation.

Accepts a JSON body with POST request.

Query types:

`type`	Returns
`fullAccount`	Complete state (margin + positions + orders + leverage settings)
`openOrders`	Resting live orders (includes conditional orders parked in conditional books)
`feeTier`	Account-only fee-tier quote snapshot (`symbol` optional). For global fee state use `GET /feeState`.
`fills`	Paginated trade fills
`positions`	Paginated closed positions
`fundingHistory`	Paginated funding payments
`orderHistory`	Paginated terminal order states
`activityHistory`	Paginated account activity
`riskHistory`	Paginated liquidation, ADL, and risk-vault events

History queries return a plain typed {data, page} object; current-state queries retain their existing array response. History limit defaults to 5000 and is bounded to 1–5000. A first page may include inclusive startSlot and endSlot bounds. A continuation includes the same type and user, cursor, and an optional changed limit; it cannot include slot bounds.

POST

account

curl --request POST \
  --url https://mainnet-api1.bulk.trade/api/v1/account \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "fullAccount",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
}
'

[
  {
    "fullAccount": {
      "kind": "<string>",
      "parent": "<string>",
      "name": "<string>",
      "subAccounts": [
        {
          "pubkey": "<string>"
        }
      ],
      "authorizedAgentWallets": [
        "<string>"
      ],
      "builderCodeApprovals": [
        {
          "recipient": "<string>",
          "maxFee": 8
        }
      ],
      "margin": {
        "totalMargin": 123,
        "availableMargin": 123,
        "executionImpact": 123,
        "transferableBalance": 123,
        "marginUsed": 123,
        "marginBufferRate": 123,
        "bufferedMargin": 123,
        "notional": 123,
        "realizedPnl": 123,
        "unrealizedPnl": 123,
        "fees": 123,
        "funding": 123,
        "aggTotalMargin": 123,
        "aggAvailableMargin": 123,
        "aggExecutionImpact": 123,
        "aggTransferableBalance": 123,
        "aggMarginUsed": 123,
        "aggBufferedMargin": 123,
        "aggNotional": 123,
        "aggRealizedPnl": 123,
        "aggUnrealizedPnl": 123,
        "aggFees": 123,
        "aggFunding": 123
      },
      "positions": [
        {
          "symbol": "<string>",
          "size": 123,
          "price": 123,
          "fairPrice": 123,
          "notional": 123,
          "realizedPnl": 123,
          "unrealizedPnl": 123,
          "leverage": 123,
          "liquidationPrice": 123,
          "fees": 123,
          "funding": 123,
          "maintenanceMargin": 123,
          "averageEntryTime": 123,
          "lambda": 123,
          "riskAllocation": 123,
          "iso": true,
          "isoPubkey": "<string>",
          "protection": {
            "orders": [
              {
                "orderId": "<string>",
                "orderType": "stop",
                "trigger": {
                  "px": 123,
                  "isAbove": true,
                  "lim": 123,
                  "oco": "<string>",
                  "pxHi": 123,
                  "limHi": 123,
                  "trb": 123,
                  "stb": 123
                }
              }
            ]
          }
        }
      ],
      "openOrders": [
        {
          "symbol": "<string>",
          "orderId": "<string>",
          "price": 123,
          "originalSize": 123,
          "size": 123,
          "filledSize": 123,
          "vwap": 123,
          "maker": true,
          "reduceOnly": true,
          "orderType": "limit",
          "trigger": {
            "px": 123,
            "isAbove": true,
            "lim": 123,
            "oco": "<string>",
            "pxHi": 123,
            "limHi": 123,
            "trb": 123,
            "stb": 123
          },
          "tif": "gtc",
          "status": "pending",
          "timestamp": 123,
          "iso": true
        }
      ],
      "pendingOnFill": [
        {
          "parentOrderId": "<string>",
          "actions": [
            {}
          ]
        }
      ],
      "feeTiers": [
        {
          "symbol": "<string>",
          "rollingVolume": 123,
          "tierIndex": 123,
          "tierThreshold": 123,
          "makerBps": 123,
          "takerBps": 123,
          "windowDays": 123
        }
      ],
      "leverageSettings": [
        {
          "symbol": "<string>",
          "leverage": 123
        }
      ],
      "lockedAmounts": [
        {
          "hash": "<string>",
          "symbol": "<string>",
          "amount": 123,
          "lockedAt": 123
        }
      ]
    }
  }
]

{
  "data": [
    {
      "tradeId": "34554078:127",
      "maker": "<string>",
      "taker": "<string>",
      "orderIdMaker": "<string>",
      "orderIdTaker": "<string>",
      "isBuy": true,
      "symbol": "<string>",
      "amount": 123,
      "price": 123,
      "makerFee": 123,
      "takerFee": 123,
      "fee": 123,
      "reasonCode": 0,
      "slot": 123,
      "timestamp": 123,
      "sequence": 123,
      "iso": true,
      "reason": "liquidation",
      "counterpartyHint": "<string>",
      "isoPubkey": "<string>"
    }
  ],
  "page": {
    "nextCursor": "<string>",
    "hasMore": true,
    "asOfSlot": 1,
    "startSlot": 1,
    "endSlot": 1,
    "coverage": "complete",
    "minAvailableSlot": 1
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

<string>

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

4 October 2026 upgrade: the account-local and aggregate margin guidance below applies after the scheduled upgrade. Public responses retain the margin object; they do not expose the SDK’s internal metrics and aggregate objects.

Query Targets

POST /account is unsigned. Current-state query types accept a master or sub-account pubkey as user. History queries use the same endpoint and may also query a physical isolated-account pubkey directly.

Pubkey passed in `user`	What you get back
Master	Master snapshot. `fullAccount` and `openOrders` include the master’s own rows plus rows from any per-instrument isolated accounts attached to it (each isolated row carries `iso = true` and `isoPubkey`).
Sub-account	Snapshot scoped to that sub-account. `kind = "SubAccount"` and `parent` is the master pubkey. Current-state views also include any per-instrument isolated-account rows attached to that sub-account.

Isolated accounts are not current-state query targets. An isolated isoPubkey is supported only by the paginated history types. Isolated accounts are managed via the i flag on order actions (see Isolated Margin); their pubkeys also appear inline on parent rows and can be used as to in margin transfer top-ups. To enumerate sub-accounts on a master, read subAccounts[] from its fullAccount response.

Request Examples

{
  "type": "fullAccount",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
}

{
  "type": "openOrders",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
}

{
  "type": "feeTier",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "symbol": "BTC-USD"
}

{
  "type": "fullAccount",
  "user": "8x7iUti9m6L6Y9yQPXkXj4zD2uP1Qx5Eo9W4vYm6cGmR"
}

{
  "type": "fills",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "limit": 500,
  "startSlot": 12000,
  "endSlot": 13000
}

{
  "type": "fills",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7",
  "limit": 1000,
  "cursor": "opaque-base64url-cursor"
}

Response Schemas

Current-state responses are an array of externally tagged objects with fullAccount, openOrder, or feeTier. History types return a plain typed {data, page} object.

History Queries

Use fills, positions, fundingHistory, orderHistory, activityHistory, or riskHistory as the request type.

limit is optional, defaults to 5000, and accepts 1–5000.
startSlot and endSlot are optional inclusive bounds on the first page.
Continue with the returned cursor. A cursor request may change limit but cannot include slot bounds.

History responses use this envelope:

{
  "data": [],
  "page": {
    "nextCursor": "opaque-base64url-cursor",
    "hasMore": true,
    "asOfSlot": 13000,
    "startSlot": 12000,
    "endSlot": 13000,
    "coverage": "complete",
    "minAvailableSlot": 12000
  }
}

Rows are ordered newest-first by slot and sequence. Always continue with nextCursor; do not construct cursors from timestamps or row fields. Fill rows include tradeId in "<slot>:<event-sequence>" form. REST history and account WebSocket views of the same execution share the same value. Treat it as an opaque network-local reconciliation key. positions history rows may include averageEntryTime when available.

Full Account Response

For type: "fullAccount". Returns account state including margin, positions, open orders, and leverage settings. The example below shows selected fields.

[
  {
    "fullAccount": {
      "kind": "MasterEOA",
      "subAccounts": [
        {"pubkey": "8x7iUti9m6L6Y9yQPXkXj4zD2uP1Qx5Eo9W4vYm6cGmR"}
      ],
      "authorizedAgentWallets": [
        "6pJ8vnrWofWgrn9doYBBRjijV5e6YJ2yN1U2EMRk4cLQ"
      ],
      "builderCodeApprovals": [
        {
          "recipient": "5Am6JkEHAjYG1itNWRMGpQrxvY8AaqkXCo1TZvenqVux",
          "maxFee": 5
        }
      ],
      "margin": {
        "totalMargin": 100000.0,
        "availableMargin": 95000.0,
        "executionImpact": 0.0,
        "transferableBalance": 94750.0,
        "marginUsed": 5000.0,
        "marginBufferRate": 0.05,
        "bufferedMargin": 5250.0,
        "notional": 50000.0,
        "realizedPnl": 1234.0,
        "unrealizedPnl": 500.0,
        "fees": 12.5,
        "funding": -5.0
      },
      "positions": [
        {
          "symbol": "BTC-USD",
          "size": 0.5,
          "price": 100000.0,
          "fairPrice": 100050.0,
          "notional": 50000.0,
          "realizedPnl": 1234.0,
          "unrealizedPnl": 500.0,
          "leverage": 5.0,
          "liquidationPrice": 80000.0,
          "fees": 12.5,
          "funding": -5.0,
          "maintenanceMargin": 2500.0,
          "averageEntryTime": 1775550000000000000,
          "lambda": 0.05,
          "riskAllocation": 0.8,
          "iso": false,
          "protection": {
            "orders": [
              {
                "orderId": "9fJdDgS8eYq9Dj8YkXTY32tRAb4gk58wEAg2a5kzCL5P",
                "orderType": "stop",
                "trigger": {
                  "px": 98000.0,
                  "lim": 97950.0,
                  "oco": null
                }
              }
            ]
          }
        }
      ],
      "openOrders": [
        {
          "symbol": "BTC-USD",
          "orderId": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F",
          "price": 100000.0,
          "originalSize": 0.1,
          "size": 0.1,
          "filledSize": 0.0,
          "vwap": 0.0,
          "maker": true,
          "reduceOnly": false,
          "orderType": "limit",
          "trigger": null,
          "tif": "gtc",
          "status": "resting",
          "timestamp": 1704067200000000000,
          "iso": false
        }
      ],
      "feeTiers": [
        {
          "symbol": "global",
          "rollingVolume": 1200000.0,
          "tierIndex": 1,
          "tierThreshold": 1000000.0,
          "makerBps": 1.8,
          "takerBps": 3.3,
          "windowDays": 14
        }
      ],
      "leverageSettings": [
        { "symbol": "BTC-USD", "leverage": 5.0 },
        { "symbol": "ETH-USD", "leverage": 3.0 }
      ],
      "lockedAmounts": [
        {
          "hash": "uQ8yioSC6fYLWwWS2XAi97vMJXKur3GKr7DEp1tdMqs",
          "symbol": "USDC",
          "amount": 500.0,
          "lockedAt": 1700000000000000000
        }
      ]
    }
  }
]

Account top-level fields:

kind - Account kind string. Current-state query responses use MasterEOA or SubAccount.
parent - Parent master pubkey for sub-accounts; omitted when no parent exists
name - Sub-account display name. Present on responses where kind: "SubAccount" (i.e. when you passed the sub-account pubkey as user); omitted on master responses.
subAccounts - Children of the master, each {pubkey}. The list contains pubkeys only; query a sub-account directly with type: "fullAccount" to see its name. See Sub-Accounts
authorizedAgentWallets - Agent wallets registered on this account that may sign on its behalf. See Manage Agent Wallets
builderCodeApprovals - Approved builder-code recipients as {recipient, maxFee}. Builder codes are builder-code fees on the wire; use abc/rbc to manage this list.
lockedAmounts - Margin locked while a transfer or withdrawal is in progress, omitted when empty. Each row contains the action hash, symbol, amount, and nanosecond lockedAt timestamp. Locks clear when the operation completes or is no longer pending.

Account-local and aggregate margin

The unprefixed fields inside margin describe the queried account only. When that account has attached isolated accounts, optional agg* fields in the same object describe the account plus those isolated accounts. These totals do not include separate sub-accounts. Do not add the unprefixed values to the agg* values: that would count the parent twice. Illustrative partial response for an account with isolated collateral:

[
  {
    "fullAccount": {
      "margin": {
        "totalMargin": 1000.0,
        "availableMargin": 900.0,
        "marginUsed": 100.0,
        "aggTotalMargin": 1250.0,
        "aggAvailableMargin": 1125.0,
        "aggMarginUsed": 125.0
      }
    }
  }
]

Field in `margin`	Meaning
`totalMargin`	Account-local margin balance
`availableMargin`	`totalMargin - marginUsed`; not the withdrawable balance
`executionImpact`	Non-positive difference between impacted and unrealized P&L
`transferableBalance`	Balance currently eligible for transfer under the account’s risk constraints
`marginUsed`	Account-local maintenance margin
`marginBufferRate`	Buffer rate applied to maintenance margin
`bufferedMargin`	`marginUsed * (1 + marginBufferRate)`
`notional`, `realizedPnl`, `unrealizedPnl`, `fees`, `funding`	Account-local reported values
`aggTotalMargin`, `aggAvailableMargin`, `aggExecutionImpact`, `aggTransferableBalance`, `aggMarginUsed`, `aggBufferedMargin`, `aggNotional`, `aggRealizedPnl`, `aggUnrealizedPnl`, `aggFees`, `aggFunding`	Corresponding parent-plus-isolated totals; omitted when no isolated owners are attached

positions and openOrders remain the combined parent-plus-isolated view, with isolated rows identified by iso and isoPubkey. Public margin fields are totalMargin and availableMargin, not totalBalance and availableBalance. Position fields: symbol, size, price, fairPrice, notional, realizedPnl, unrealizedPnl, leverage, liquidationPrice, fees, funding, maintenanceMargin, averageEntryTime, lambda, riskAllocation, iso

averageEntryTime - Average entry time in nanoseconds.
iso - true if the position belongs to a per-instrument isolated account attached to this master/sub-account; otherwise false
isoPubkey - Present only when iso=true; pubkey of the isolated account. Use as to in transfer to top up isolated-account margin. It is valid as user for history queries, but not for current-state queries.
protection - Optional attached reduce-only protective orders for this symbol

Open Orders Response

For type: "openOrders". Returns up to 5000 resting orders; each item is an object with key openOrder.

[
  {
    "openOrder": {
      "symbol": "BTC-USD",
      "orderId": "Fpa3oVuL3UzjNANAMZZdmrn6D1Zhk83GmBuJpuAWG51F",
      "price": 99000.0,
      "originalSize": 0.1,
      "size": 0.1,
      "filledSize": 0.0,
      "vwap": 0.0,
      "maker": true,
      "reduceOnly": false,
      "orderType": "limit",
      "trigger": null,
      "tif": "gtc",
      "status": "resting",
      "timestamp": 1699564800000000000,
      "iso": false
    }
  }
]

For master/sub accounts, the response also includes per-instrument isolated-account rows (iso=true) belonging to that account tree. Order-state tif values are gtc, ioc, postOnly, postOnlySlide, and postOnlyJoin. The last two correspond to the JSON request values ALO_SLIDE and ALO_JOIN; see Place & Cancel Orders.

Fee Tier Response

For type: "feeTier". Returns the account-only fee-tier quote snapshot. For global fee-state (policy, schedules, settlement totals) use GET /feeState.

[
  {
    "feeTier": {
      "scopeInstrument": "BTC-USD",
      "rollingVolume": 1200000.0,
      "tierIndex": 1,
      "tierThreshold": 1000000.0,
      "makerBps": 1.8,
      "takerBps": 3.3,
      "windowDays": 14
    }
  }
]

Fee Tier Fields:

scopeInstrument - Instrument scope resolved for this quote
rollingVolume - Account rolling volume in resolved scope window
tierIndex - Active tier index (0-based)
tierThreshold - Threshold volume of the active tier row
makerBps / takerBps - Effective bps at current tier
windowDays - Rolling window length in days

Real-time Updates

For real-time account updates, use the WebSocket account stream.

{
  "method": "subscribe",
  "subscription": [{
    "type": "account",
    "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
  }]
}

Body

application/json

Unsigned current-state or paginated-history query

type

enum<string>

required

feeTier returns the account-only fee-tier quote; use GET /feeState for global fee policy/schedule snapshots.

Available options:

fullAccount,

openOrders,

feeTier,

fills,

positions,

fundingHistory,

orderHistory,

activityHistory,

riskHistory

user

string

required

Account public key (base58)

Example:

"FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"

symbol

string

Optional market symbol for feeTier

Example:

"BTC-USD"

limit

integer

default:5000

Optional page size for history queries

Required range: 1 <= x <= 5000

startSlot

integer<int64>

Optional inclusive lower slot bound for the first history page

Required range: x >= 0

endSlot

integer<int64>

Optional inclusive upper slot bound for the first history page

Required range: x >= 0

cursor

string

Opaque history continuation; cannot be combined with slot bounds

Response

Current-state array or complete/default-policy typed history page

Option 1
Option 2
Option 3

fullAccount

object

required

Complete account state with account tree, margin, positions, orders, and leverage settings

Show child attributes

curl --request POST \
  --url https://mainnet-api1.bulk.trade/api/v1/account \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "fullAccount",
  "user": "FuueqefENiGEW6uMqZQgmwjzgpnb85EgUcZa5Em4PQh7"
}
'

[
  {
    "fullAccount": {
      "kind": "<string>",
      "parent": "<string>",
      "name": "<string>",
      "subAccounts": [
        {
          "pubkey": "<string>"
        }
      ],
      "authorizedAgentWallets": [
        "<string>"
      ],
      "builderCodeApprovals": [
        {
          "recipient": "<string>",
          "maxFee": 8
        }
      ],
      "margin": {
        "totalMargin": 123,
        "availableMargin": 123,
        "executionImpact": 123,
        "transferableBalance": 123,
        "marginUsed": 123,
        "marginBufferRate": 123,
        "bufferedMargin": 123,
        "notional": 123,
        "realizedPnl": 123,
        "unrealizedPnl": 123,
        "fees": 123,
        "funding": 123,
        "aggTotalMargin": 123,
        "aggAvailableMargin": 123,
        "aggExecutionImpact": 123,
        "aggTransferableBalance": 123,
        "aggMarginUsed": 123,
        "aggBufferedMargin": 123,
        "aggNotional": 123,
        "aggRealizedPnl": 123,
        "aggUnrealizedPnl": 123,
        "aggFees": 123,
        "aggFunding": 123
      },
      "positions": [
        {
          "symbol": "<string>",
          "size": 123,
          "price": 123,
          "fairPrice": 123,
          "notional": 123,
          "realizedPnl": 123,
          "unrealizedPnl": 123,
          "leverage": 123,
          "liquidationPrice": 123,
          "fees": 123,
          "funding": 123,
          "maintenanceMargin": 123,
          "averageEntryTime": 123,
          "lambda": 123,
          "riskAllocation": 123,
          "iso": true,
          "isoPubkey": "<string>",
          "protection": {
            "orders": [
              {
                "orderId": "<string>",
                "orderType": "stop",
                "trigger": {
                  "px": 123,
                  "isAbove": true,
                  "lim": 123,
                  "oco": "<string>",
                  "pxHi": 123,
                  "limHi": 123,
                  "trb": 123,
                  "stb": 123
                }
              }
            ]
          }
        }
      ],
      "openOrders": [
        {
          "symbol": "<string>",
          "orderId": "<string>",
          "price": 123,
          "originalSize": 123,
          "size": 123,
          "filledSize": 123,
          "vwap": 123,
          "maker": true,
          "reduceOnly": true,
          "orderType": "limit",
          "trigger": {
            "px": 123,
            "isAbove": true,
            "lim": 123,
            "oco": "<string>",
            "pxHi": 123,
            "limHi": 123,
            "trb": 123,
            "stb": 123
          },
          "tif": "gtc",
          "status": "pending",
          "timestamp": 123,
          "iso": true
        }
      ],
      "pendingOnFill": [
        {
          "parentOrderId": "<string>",
          "actions": [
            {}
          ]
        }
      ],
      "feeTiers": [
        {
          "symbol": "<string>",
          "rollingVolume": 123,
          "tierIndex": 123,
          "tierThreshold": 123,
          "makerBps": 123,
          "takerBps": 123,
          "windowDays": 123
        }
      ],
      "leverageSettings": [
        {
          "symbol": "<string>",
          "leverage": 123
        }
      ],
      "lockedAmounts": [
        {
          "hash": "<string>",
          "symbol": "<string>",
          "amount": 123,
          "lockedAt": 123
        }
      ]
    }
  }
]

{
  "data": [
    {
      "tradeId": "34554078:127",
      "maker": "<string>",
      "taker": "<string>",
      "orderIdMaker": "<string>",
      "orderIdTaker": "<string>",
      "isBuy": true,
      "symbol": "<string>",
      "amount": 123,
      "price": 123,
      "makerFee": 123,
      "takerFee": 123,
      "fee": 123,
      "reasonCode": 0,
      "slot": 123,
      "timestamp": 123,
      "sequence": 123,
      "iso": true,
      "reason": "liquidation",
      "counterpartyHint": "<string>",
      "isoPubkey": "<string>"
    }
  ],
  "page": {
    "nextCursor": "<string>",
    "hasMore": true,
    "asOfSlot": 1,
    "startSlot": 1,
    "endSlot": 1,
    "coverage": "complete",
    "minAvailableSlot": 1
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

<string>

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "INVALID_HISTORY_QUERY",
    "message": "<string>"
  }
}

Getting Started

Market Data (HTTP)

Account (HTTP - Unsigned)

Trading (HTTP - Signed)

Testnet

WebSocket API

Query Account (Unsigned)

Query Targets

Request Examples

Response Schemas

History Queries

Full Account Response

Account-local and aggregate margin

Open Orders Response

Fee Tier Response

Real-time Updates

Body

Response

​Query Targets

​Request Examples

​Response Schemas

​History Queries

​Full Account Response

​Account-local and aggregate margin

​Open Orders Response

​Fee Tier Response

​Real-time Updates

Body

Response

Query Targets

Request Examples

Response Schemas

History Queries

Full Account Response

Account-local and aggregate margin

Open Orders Response

Fee Tier Response

Real-time Updates