REST API›Trade›Margin

POST

Create collateral withdrawal request

Create a collateral withdrawal request.

Path Params

  • accountId string required
    The ID of the account

Body Params

object

  • currency string required
    Currency symbol for withdrawal
  • quantity string decimal required
    Amount to withdraw

Responses

202
Collateral withdrawal request accepted for processing

Response Body

object

  • id string uuid required
    Unique identifier for the withdrawal request
  • accountId string required
    Account ID associated with the withdrawal request
  • enterpriseId string required
    Enterprise ID associated with the withdrawal request
  • currency string required
    Currency symbol for the withdrawal
  • quantity string decimal required
    Amount requested for withdrawal
  • status string enum required
    Current status of the withdrawal request
    pendingapprovedrejectedcompletedcancelled
  • createdBy string required
    User who created the withdrawal request
  • canceledBy string nullable
    User who canceled the withdrawal request, if applicable
  • creationDate string date-time required
    Timestamp when the request was created
  • modifiedDate string date-time required
    Timestamp when the request was last modified
400
Bad request - Invalid parameters

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
401
Unauthorized - Invalid or missing authentication

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
403
Forbidden - Insufficient permissions

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
409
Conflict - A pending withdrawal request already exists for this currency

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
422
Unprocessable Entity - JSON payload is improperly formatted

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
429
Too Many Requests - Rate limit exceeded

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
500
Internal Server Error

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.