Skip to main content

Get account bootstrap payload

GET 
/api/v1/accounts/:account/bootstrap

Operational integration notes​

Use this endpoint for the authoritative pre-trade account snapshot. The account path parameter is the 20-byte engine account, not the 32-byte accountIdHex returned by trading-account control-plane APIs.

FieldMeaning
Engine account20-byte account used by matching-engine balances, signed actions, FIX/FIXP, and private streams.
accountIdHex32-byte trading-account id used for control-plane/account-list records. Do not pass it to this route.
Owner wallet20-byte wallet that owns or administers agents and trading accounts.

Call with fresh=true before the first quote, after risk rejects, and after a nonce resync. For institutional preflight, treat risk.freeUsdcMicro or balances.freeUsdcMicro from the fresh bootstrap as the operational free-USDC value. If both are present, log both and stop on a material mismatch.

cURL​

curl "$SENTICORE_API_BASE_URL/api/v1/accounts/$ENGINE_ACCOUNT/bootstrap?fresh=true" \
  -H "SC-Auth-Version: 2" \
  -H "SC-Key: $API_KEY_ID" \
  -H "SC-Nonce: $SC_NONCE" \
  -H "SC-Timestamp: $SC_TIMESTAMP" \
  -H "SC-Passphrase: $API_PASSPHRASE" \
  -H "SC-Signature: $SC_SIGNATURE"

Expected fields​

{
  "account": "0x2222222222222222222222222222222222222222",
  "balanceSource": "matching_engine",
  "syncStatus": "synced",
  "balances": {
    "freeUsdcMicro": "100000000",
    "lockedUsdcMicro": "0",
    "inOrdersUsdcMicro": "0"
  },
  "risk": {
    "freeUsdcMicro": "100000000"
  },
  "nonceFloor": 0,
  "nonceWindow": 256
}

If a risk reject follows a fresh funded bootstrap, include the engine account, market, book, side, price, qty, required USDC micro, nonceFloor, and the full redacted submit response in the support payload.

Authoritative pre-trade account snapshot. The account path parameter is the 20-byte engine account. Do not pass a 32-byte accountIdHex from trading-account control-plane APIs. Use fresh=true before the first institutional quote, after risk rejects, and after nonce resync.

Request​

Responses​

Account bootstrap payload

Last updated on