Get Positions

curl -X GET "https://api.strike.markets/positions/0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

{
  "open": [
    {
      "id": 12345,
      "walletAddress": "0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46",
      "symbol": "BTC-USD",
      "szi": "0.006667",
      "margin": "300.0",
      "entryPrice": "45000.00",
      "liquidationPrice": "41234.15",
      "exitPrice": null,
      "realizedPnl": "0.00",
      "pnlFee": "0.00",
      "status": "open",
      "createdAt": "2024-01-15T14:30:00Z",
      "closedAt": null,
      "settledAt": null,
      "accumulatedFunding": "2.50",
      "spread": "5.25"
    }
  ],
  "closed": [
    {
      "id": 12340,
      "walletAddress": "0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46",
      "symbol": "BTC-USD",
      "szi": "0.018182",
      "margin": "100.0",
      "entryPrice": "44000.00",
      "liquidationPrice": "40150.00",
      "exitPrice": "45500.00",
      "realizedPnl": "127.85",
      "pnlFee": "8.75",
      "status": "closed",
      "createdAt": "2024-01-10T09:00:00Z",
      "closedAt": "2024-01-12T15:30:00Z",
      "settledAt": null,
      "accumulatedFunding": "3.50",
      "spread": "4.75"
    }
  ],
  "settled": [
    {
      "id": 12330,
      "symbol": "SOL-USD",
      "wallet_address": "0x742d35cc6c6c7532b1140da4c8a2f6c8ecfc9b46",
      "szi": "0.078947",
      "margin": "75.0",
      "entry_price": "95.00",
      "liquidation_price": "90.25",
      "exit_price": "90.25",
      "realized_pnl": "-75.00",
      "total_fee": "0.00",
      "status": "settled",
      "created_at": "2024-01-05T08:30:00Z",
      "closed_at": "2024-01-06T14:15:00Z",
      "settled_at": "2024-01-06T14:15:00Z"
    }
  ]
}

Overview

Retrieve all positions for a specific wallet address, organized by their current status. This endpoint provides comprehensive position data including real-time PnL calculations for open positions.

This endpoint does NOT require authentication and can be called for any wallet address. Position data is publicly accessible on the blockchain.

Path Parameters

wallet_address

string

required

Ethereum wallet address to retrieve positions for.Format: 42-character hex string starting with “0x”
Example: “0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46”

Response Structure

Position Collections

open

array

Currently active positions with reserved margin

closed

array

Positions manually closed by user, may be pending payout

settled

array

Positions fully processed (liquidated or payout completed)

Position Object Properties

integer

Unique identifier for the position (contract position ID)

symbol

string

Trading pair symbol (e.g., “BTC-USD”, “ETH-USD”, “SOL-USD”, “BNB-USD”, “XRP-USD”, “HYPE-USD”)

wallet_address

string

Owner’s wallet address (lowercase hex format)

szi

string

Position size in base asset units (positive=long, negative=short)

margin

string

Initial margin amount used to open the position (USD)

entry_price

string

Price at which the position was opened

liquidation_price

string

Price at which the position will be liquidated

exit_price

string

Price at which position was closed (null for open positions)

realized_pnl

string

Final realized profit/loss when closed (0.00 for open positions)

total_fee

string

Total fees paid on the position (0.00 for open positions)

status

string

Position status: “open”, “closed”, or “settled”

created_at

string

ISO timestamp when the position was created

closed_at

string

ISO timestamp when the position was closed (null for open positions)

settled_at

string

ISO timestamp when position was fully settled (null for open/closed positions)

Position Status Definitions

Open Positions

Status: “open”
Characteristics: Active positions with ongoing market exposure
PnL: Real-time unrealized profit/loss calculations
Actions: Can be closed manually or liquidated automatically
Margin: Reserved from account balance

Closed Positions

Status: “closed”
Characteristics: Manually closed by user through Close Position
PnL: Final realized profit/loss (unrealizedPnl shows 0)
Closure: User-initiated at market price
Settlement: Immediate or queued based on available funds

Settled Positions

Status: “liquidated” or “settled”
Characteristics: Automatically closed by the system
Liquidation: Closed when reaching liquidation price
Settlement: System-initiated closure
Timing: Occurs automatically based on market conditions

Error Responses

400 Bad Request

object

Invalid wallet address format

{
  "error": 400,
  "message": "Invalid wallet address format"
}

404 Not Found

object

Wallet address not found in system (no positions)

{
  "error": 404,
  "message": "No positions found for this wallet address"
}

Dashboard - Includes position data plus other account information
Queue Positions - Check payout queue status for closed positions
Close Position - Close open positions manually
Emergency Exit - Emergency exit from positions

Monitor open positions frequently as unrealized PnL changes with market prices. Consider setting up alerts for positions approaching liquidation.

Position data includes sensitive trading information. While publicly accessible, use appropriate security measures when displaying this data in applications.

Authorizations

X-API-Key

string

header

required

Strike Protocol API key authentication

Path Parameters

wallet_address

string

required

Ethereum wallet address

Response

Positions retrieved successfully

openPositions

object[]

Show child attributes

openPositions.positionId

integer

openPositions.symbol

string

openPositions.side

enum<string>

Available options:

long,

short

openPositions.margin

string

openPositions.leverage

integer

openPositions.size

string

openPositions.entryPrice

string

openPositions.markPrice

string

openPositions.liquidationPrice

string

openPositions.unrealizedPnl

string

openPositions.status

string

openPositions.createdAt

string<date-time>

openPositions.closedAt

string<date-time>

closedPositions

object[]

Show child attributes

closedPositions.positionId

integer

closedPositions.symbol

string

closedPositions.side

enum<string>

Available options:

long,

short

closedPositions.margin

string

closedPositions.leverage

integer

closedPositions.size

string

closedPositions.entryPrice

string

closedPositions.markPrice

string

closedPositions.liquidationPrice

string

closedPositions.unrealizedPnl

string

closedPositions.status

string

closedPositions.createdAt

string<date-time>

closedPositions.closedAt

string<date-time>

settledPositions

object[]

Show child attributes

settledPositions.positionId

integer

settledPositions.symbol

string

settledPositions.side

enum<string>

Available options:

long,

short

settledPositions.margin

string

settledPositions.leverage

integer

settledPositions.size

string

settledPositions.entryPrice

string

settledPositions.markPrice

string

settledPositions.liquidationPrice

string

settledPositions.unrealizedPnl

string

settledPositions.status

string

settledPositions.createdAt

string<date-time>

settledPositions.closedAt

string<date-time>

Getting Started

API Key Management

Trading Operations

Account Management

Position Management

Data & Analytics

Overview

Path Parameters

Response Structure

Position Collections

Position Object Properties

Position Status Definitions

Open Positions

Closed Positions

Settled Positions

Error Responses

Authorizations

Path Parameters

Response

Getting Started

API Key Management

Trading Operations

Account Management

Position Management

Data & Analytics

​Overview

​Path Parameters

​Response Structure

​Position Collections

​Position Object Properties

​Position Status Definitions

​Open Positions

​Closed Positions

​Settled Positions

​Error Responses

​Related Endpoints

Authorizations

Path Parameters

Response

Overview

Path Parameters

Response Structure

Position Collections

Position Object Properties

Position Status Definitions

Open Positions

Closed Positions

Settled Positions

Error Responses

Related Endpoints