Skip to main content
GET
/
positions
/
{wallet_address}
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"
    }
  ]
}

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

​
id
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"
}
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[]
​
closedPositions
object[]
​
settledPositions
object[]