Account

Account information, positions, balances, and history

User login

post

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

/login

Authenticate user and create session

Body

application/json

addressstringOptional

Responses

200

Login successful

application/json

post

/login

HTTPcURLJavaScriptPython

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

{
  "address": "text",
  "signature": {
    "r": "0x1234...",
    "s": "0x5678...",
    "v": 27
  }
}

200

Login successful

{
  "token": "text",
  "expiresAt": 1
}

Get user information

post

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

/user

Fetch user account details, positions, and settings

Body

application/json

addressstringOptional

Responses

200

User information

application/json

post

/user

HTTPcURLJavaScriptPython

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

{
  "address": "text"
}

200

User information

{
  "address": "text",
  "positions": [
    {
      "coin": "BTC",
      "szi": "1.5",
      "leverage": {
        "type": "cross",
        "value": 10
      },
      "entryPx": "43000.00",
      "positionValue": "64500.00",
      "unrealizedPnl": "375.75",
      "liquidationPx": "38700.00",
      "marginUsed": "6450.00"
    }
  ],
  "balance": "text"
}