Collateral Approval

Approve collateral for trading. The `amt` field can be either a number or a string `max`. Setting the approval to max will ensure no approvals are needed prior to a trade. This may also save gas costs and reduce code complexity. Alternatively, it is possible to approve only the amount intended to be traded (plus trading fees if applicable) for each order quoted or filled.

POST/account/collateral_approval

Authorization

api_key

Body

application/json

token*string

Example: "WETH"

amt*one of

Example: "max"

numberstring

Response

200400401

Approved

Body

application/json

successarray of object

failedarray of object

Request

JavaScriptCurlPython

const response = await fetch('/account/collateral_approval', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      {
        "token": "WETH",
        "amt": "max"
      }
    ]),
});
const data = await response.json();

Response

200400401

{
  "success": [
    {
      "token": "WETH",
      "amt": "max"
    }
  ],
  "failed": [
    {
      "failedApproval": {
        "token": "WETH",
        "amt": "max"
      },
      "reason": "text"
    }
  ]
}