Get Positions

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

const walletAddress = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46";

const response = await fetch(`https://api.strike.markets/positions/${walletAddress}`);
const positions = await response.json();

console.log('User positions:', positions);

import requests

wallet_address = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

response = requests.get(f'https://api.strike.markets/positions/{wallet_address}')
positions = response.json()

print('User positions:', positions)

{
  "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"
    }
  ]
}

GET

positions

{wallet_address}

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

const walletAddress = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46";

const response = await fetch(`https://api.strike.markets/positions/${walletAddress}`);
const positions = await response.json();

console.log('User positions:', positions);

import requests

wallet_address = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

response = requests.get(f'https://api.strike.markets/positions/{wallet_address}')
positions = response.json()

print('User positions:', positions)

{
  "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"
    }
  ]
}

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

const walletAddress = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46";

const response = await fetch(`https://api.strike.markets/positions/${walletAddress}`);
const positions = await response.json();

console.log('User positions:', positions);

import requests

wallet_address = "0x742d35cc6C6C7532B1140Da4C8A2f6C8ECfC9B46"

response = requests.get(f'https://api.strike.markets/positions/{wallet_address}')
positions = response.json()

print('User positions:', positions)

{
  "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

string

required

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

Response Structure

Position Collections

array

Currently active positions with reserved margin

array

Positions manually closed by user, may be pending payout

array

Positions fully processed (liquidated or payout completed)

Position Object Properties

integer

Unique identifier for the position (contract position ID)

string

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

string

Owner’s wallet address (lowercase hex format)

string

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

string

Initial margin amount used to open the position (USD)

string

Price at which the position was opened

string

Price at which the position will be liquidated

string

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

string

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

string

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

string

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

string

ISO timestamp when the position was created

string

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

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

object

Invalid wallet address format

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

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.

Path Parameters

wallet_address

string

required

Ethereum wallet address

Pattern: ^0x[a-fA-F0-9]{40}$

Response

Positions retrieved successfully

openPositions

object[]

Show child attributes

closedPositions

object[]

Show child attributes

settledPositions

object[]

Show child attributes

Dashboard Get Queue Positions

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

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

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