Trading

Order placement, modification, and cancellation

Execute exchange action

post

https://api.margin.tradehttp://localhost:8080

/exchange

Main trading endpoint for placing orders, canceling, modifying, transfers, and other exchange actions. Requires EIP-712 signature.

Body

application/json

nonceinteger · int64Required

Timestamp in milliseconds, must be recent

vaultAddressstring · nullableRequired

Vault address if trading from vault

Responses

200

Action executed successfully

application/json

400

Invalid request

application/json

post

/exchange

HTTPcURLJavaScriptPython

POST /exchange HTTP/1.1
Host: api.margin.trade
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "action": {
    "type": "order",
    "orders": [
      {
        "a": 0,
        "b": true,
        "p": "43250.00",
        "s": "0.1",
        "r": false,
        "t": {
          "limit": {
            "tif": "Gtc"
          }
        }
      }
    ]
  },
  "nonce": 1705790400000,
  "signature": {
    "r": "0x1234...",
    "s": "0x5678...",
    "v": 27
  },
  "vaultAddress": null
}

Place a limit orderCancel an order

{
  "status": "ok",
  "response": {
    "type": "order",
    "data": {
      "statuses": [
        {
          "resting": {
            "oid": 1,
            "cloid": "text"
          },
          "filled": {
            "totalSz": "text",
            "avgPx": "text",
            "oid": 1
          },
          "error": "text"
        }
      ]
    }
  }
}