List Margin Charge Records

Retrieve a paginated list of margin charge records for forward deals. Supports filtering by deal ID, margin scene, status, and creation date range. Useful for tracking margin freezes, additions, and releases.
Request Parameters
limitinteger
Number of results per page. Range: 1–100. Defaults to 20 if not specified.
cursorstring
Pagination cursor from a previous response. Omit for the first page.
dealIdstring
Filter by deal ID. Returns only margin records associated with the specified deal.
scenestring
Filter by margin scene. See MarginScene.
statusstring
Filter by margin charge status. See MarginChargeStatus.
fromCreatedAtdatetime
Start of the creation time filter, following the ISO 8601 standard. See Data Types. Maximum range: 31 days.
toCreatedAtdatetime
End of the creation time filter, following the ISO 8601 standard. See Data Types.
Response Parameters
resultResult
See Result.
prevCursorstring
Cursor for the previous page.
nextCursorstring
Cursor for the next page.
itemsarray
List of MarginChargeRecord objects.
Show child parametersShow child parameters
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
Definition
POST /api/open/v1/fx/deals/listMarginChargeRecords
Request
{
"limit": 10,
"dealId": "DEAL20260402001",
"scene": "INITIAL_MARGIN"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"items": [
  {
    "id": "MARGIN20260402001",
    "dealRequestId": "REQ20260402001",
    "dealId": "DEAL20260402001",
    "scene": "INITIAL_MARGIN",
    "action": "FREEZE",
    "status": "SUCCESS",
    "amount": {
      "currency": "USD",
      "value": 2500
    },
    "succeededAt": "2026-04-02T04:30:00Z",
    "createdAt": "2026-04-02T04:10:00Z"
  }
]
}