Perp Isolated

Get trade

GET/perp/isolated/tradePrivate

Get one of your trades in any state, of any perpetual market, by its id or its clientId (pass exactly one). A running trade pl is the unrealized P&L, valued at the Mark price, or null while its market has no price. An unknown trade fails with NOT_FOUND.

Permissions: futures:isolated:read

Query Parameters

id?string

Trade ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
clientId?string

Client ID given when the trade was placed

Lengthlength <= 64

Response Body

OK

application/json
  1. response
id*string

Internal trade ID

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
instrument*string

Instrument of the market

Value in"inverse_perp""quanto_perp"
pair*string

Pair of the market

type*"limit"

Open trades are always limit orders

Value in"limit"
side*string

Trade side

Value in"buy""sell"
openingFee*integer

Fee to be paid when opening the position

closingFee*integer

Fee for closing (0 until position is opened)

maintenanceMargin*integer

Maintenance margin (0 until position is opened)

quantity*number

Number of contracts to trade

entryNotionalUsd*number

Notional value at entry (in USD)

exitNotionalUsd*|

Notional value at exit (in USD), null until the trade is closed

margin*integer

Margin reserved for the order

leverage*number

Leverage multiplier for the position

price*number

Limit price at which to enter the position (in USD)

liquidation*number

Calculated liquidation price for the position (in USD)

stoploss*number

Stop loss price level (0 if not set, in USD)

takeprofit*number

Take profit price level (0 if not set, in USD)

stoplossTrailingDistance*number

Trailing stop distance as a fraction of price (0 if not trailing)

exitPrice*|

Exit price (0 until position is closed, in USD)

pl*integer

Profit and loss (0 until position is opened)

createdAt*string

Timestamp when the order was created

Formatdate-time
filledAt*null

Timestamp when filled (null while order is open)

closedAt*null

Timestamp when closed (null while order is open)

entryPrice*number

Intended entry price for the position (in USD)

entryMargin*integer

Initial margin reserved for the order

entryBtcPrice*number

Bitcoin price the sats amounts of the trade are valued at (in USD)

open*boolean

Whether the trade is open (waiting to be filled)

running*boolean

Whether the trade is running (false until filled)

canceled*boolean

Whether the trade was canceled

closed*boolean

Whether the trade is closed

sumFundingFees*integer

Funding fees (0 until position is opened)

sumQuantoAdjustmentFees*integer

Total quanto adjustment fees accumulated for the position

sumCashInPl*integer

Total amount cashed in from PL over the trade lifetime

sumCashInMargin*integer

Total amount cashed in from margin over the trade lifetime

clientId*|

Optional custom data field (max 64 characters)

label*|

Optional free label (max 64 characters) to group or tag trades, e.g. by strategy. Not unique.

Defaultnull
import { createHttpClient } from '@ln-markets/sdk/rest/v3'

const client = createHttpClient({
  key: 'your-key',
  secret: 'your-secret',
  passphrase: 'your-passphrase',
})

const result = await client.perp.isolated.getTrade({
  id: 'd0b9f9a0-4f6e-4a5a-8b7a-7f0f5f9a8a1e',
  clientId: 'test-client-id-123'
})
{
  "id": "d0b9f9a0-4f6e-4a5a-8b7a-7f0f5f9a8a1e",
  "instrument": "inverse_perp",
  "pair": "btc_usd",
  "type": "limit",
  "side": "buy",
  "openingFee": 10,
  "closingFee": 0,
  "maintenanceMargin": 0,
  "quantity": 100,
  "entryNotionalUsd": 100,
  "exitNotionalUsd": null,
  "margin": 1000,
  "leverage": 10,
  "price": 20000,
  "liquidation": 18000,
  "stoploss": 10,
  "takeprofit": 10,
  "stoplossTrailingDistance": 0,
  "exitPrice": 0,
  "pl": 0,
  "createdAt": "2025-09-01T15:04:21.129Z",
  "filledAt": null,
  "closedAt": null,
  "entryPrice": 20000,
  "entryMargin": 1000,
  "entryBtcPrice": 100000,
  "open": true,
  "running": false,
  "canceled": false,
  "closed": false,
  "sumFundingFees": 0,
  "sumQuantoAdjustmentFees": 0,
  "sumCashInPl": 0,
  "sumCashInMargin": 0,
  "clientId": "test-client-id-123",
  "label": "strategy-a"
}

Close trade POST

Close a running trade at the bid (long) or ask (short) price for its size. Its margin plus P&L, and the maintenance margin left after the closing fee, are…

Place trade POST

Place a new isolated trade on a perpetual market. Returns the trade: running for a market order, open for a limit order until it fills. Limit order…