Developer Portal
Admin APIsAccounts & FundingFunding

Deal HistoryGET

Return historical balance and trading deals in an inclusive UTC-second range, ordered by newest creation second. Reuse the returned nextToken unchanged to fetch each subsequent page.

View as Markdown
GET
/accounts/{accountId}/deals

Authorization

Authorization<token>

Bearer access token issued by the admin login flow.

In: header

Path Parameters

accountIdRequiredstring

Query Parameters

limitinteger

Number of deals to return (default: 10, max: 100)

Format: "int32"
fromstring

Inclusive lower bound, truncated to a UTC second. Omit for all history.

Format: "date-time"
tostring

Inclusive upper bound, truncated to a UTC second. Omit to use the current time.

Format: "date-time"
nextTokenstring

Opaque cursor from the previous response; omit for the first page.

curl -X GET "https://example.com/accounts/<string>/deals?limit=0&from=2019-08-24T14%3A15%3A22Z&to=2019-08-24T14%3A15%3A22Z&nextToken=%3Cstring%3E" \
  -H "Authorization: <token>"

A successful response.

{
  "deals": [
    {
      "id": "string",
      "symbolName": "string",
      "comment": "string",
      "accountId": "string",
      "orderId": "string",
      "positionId": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "symbolId": "string",
      "closedVolume": "string",
      "volume": 0.1,
      "amount": 0.1,
      "amountRaw": 0.1,
      "closePrice": 0.1,
      "closePriceRaw": 0.1,
      "openPrice": 0.1,
      "openPriceRaw": 0.1,
      "margin": 0.1,
      "commission": 0.1,
      "commissionRaw": 0.1,
      "action": "DEAL_ACTION_UNSPECIFIED",
      "direction": "DEAL_DIRECTION_UNSPECIFIED",
      "userId": "string",
      "clientDealId": "string",
      "rawRate": 0.1,
      "appliedRate": 0.1,
      "prevBalance": 0.1,
      "newBalance": 0.1,
      "fxRate": 0.1,
      "fxRateMarked": 0.1,
      "fxMarkupAmount": 0.1,
      "fxRateComm": 0.1,
      "fxRateCommMarked": 0.1,
      "fxMarkupAmountComm": 0.1,
      "amountUsd": 0.1,
      "commissionUsd": 0.1,
      "fxMarkupAmountUsd": 0.1,
      "fxMarkupAmountCommUsd": 0.1,
      "fxToUsd": 0.1,
      "notionalUsd": 0.1,
      "priceMarkupAmountUsd": 0.1
    }
  ],
  "hasMore": true,
  "nextToken": "string"
}

Credit Out

Decrease the account credit ledger. Requires the 'funding:credit-out' permission. Credit may go negative; policy lives in CRM.

Deposit Funds

Create a deposit transaction that credits funds to the specified trading account. Requires the 'funding:deposit' permission; callers without it receive 403 AUTH_NO_PERMISSION (onboarding-only tokens do not include funding access).