Sign in

v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB
Portfolio

Get orders

Retrieve open orders for a wallet address. Pass providerId or providerIds (one or more providers).

post/v1/orders

Request body

providerId'hyperliquid' | 'hyperliquid-xyz'

Single provider identifier. At least one of providerId or providerIds must be provided.

providerIdsstring[]

Filter by multiple providers (CSV, repeated query params, or JSON array). At least one of providerId or providerIds must be provided. When both providerId and providerIds are set, results include all listed providers.

addressstring required

User wallet address

Example request

{
  "providerId": "hyperliquid",
  "providerIds": [
    "hyperliquid",
    "hyperliquid-xyz"
  ],
  "address": "0x1234..."
}

Response

User orders

marketIdstring required

Market ID

side'long' | 'short' required

Order side

type'market' | 'limit' | 'stop_loss' | 'take_profit' required

Normalized order type

sizestring required

Order size in base asset

limitPricenumber

Limit price

triggerPricenumber

Trigger price

leveragenumber

Current leverage setting for this asset, when available from the underlying venue

marginnumber

Margin for this order, derived from current venue state when available. This is an estimate, not an exact exchange-reported value.

reduceOnlyboolean required

Reduce only flag

createdAtnumber required

Creation timestamp

Example response

[
  {
    "marketId": "hyperliquid-eth-usdc",
    "size": "0.5",
    "limitPrice": 3900,
    "leverage": 10,
    "margin": 12.5,
    "createdAt": 1733332000,
    "pendingActions": [
      {
        "label": "Close Position",
        "args": {
          "amount": "1.5",
          "amountRaw": "1500000",
          "repayAll": true,
          "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "collateralTokenAddress": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "collateralAmount": "0.5",
          "collateralAmountRaw": "50000000",
          "borrowAmount": "100",
          "targetLtv": "0.1",
          "marketId": "morpho-blue-borrow-base-cbbtc-usdc-86"
        }
      }
    ]
  }
]