Data Fetching

Retrieve information about positions, limit orders, and pool details

Get user perpetual positions

get

Retrieves active and pending perpetual positions for a given wallet address.

Query parameters
addressstringRequired

User's wallet address

Responses
200

List of perpetual positions

application/json
get
GET /api/perpetuals/getPositions HTTP/1.1
Host: app.strikefinance.org
Accept: */*

[
  {
    "position": "Long",
    "positionSize": 1,
    "leverage": 1,
    "stopLoss": 1,
    "takeProfit": 1,
    "asset": {
      "ticker": "text",
      "asset": {
        "policyId": "text",
        "assetName": "text"
      },
      "type": "text",
      "url": "text",
      "decimals": 1,
      "dex": "text",
      "perpAuthPolicyId": "text"
    },
    "collateral": {
      "amount": 1,
      "ticker": "text",
      "includeStrike": true,
      "strikeAmount": 1
    },
    "entryPrice": 1,
    "isPending": true,
    "outRef": {
      "txHash": "text",
      "outputIndex": 1
    },
    "status": "Pending",
    "liquidationPrice": 1,
    "version": 1,
    "hourlyBorrowFee": 1,
    "originalTxHash": "text"
  }
]

Get Pool Information V2

get

Retrieves cached or fresh pool information for perpetual trading pools.

Responses
200

Successfully retrieved pool information

application/json
get
GET /api/perpetuals/getPoolInfoV2 HTTP/1.1
Host: app.strikefinance.org
Accept: */*

{
  "data": {
    "totalAssetAmount": 1,
    "availableAssetAmount": 1,
    "totalLpMinted": 1,
    "totalValueLocked": 1
  }
}

Get Limit Orders

get

Retrieves all limit orders for a specific address, including both on-chain and pending orders.

Query parameters
addressstringRequired

The Cardano address to get limit orders for

Example: addr1q...
Responses
200

Successfully retrieved limit orders

application/json
get
GET /api/perpetuals/getLimitOrders HTTP/1.1
Host: app.strikefinance.org
Accept: */*

[
  {
    "type": "Long",
    "asset": "text",
    "size": 1,
    "price": 1,
    "timeInForce": "text",
    "status": "Pending",
    "date": 1,
    "leverage": 1,
    "stopLoss": 1,
    "takeProfit": 1,
    "collateralAmount": 1,
    "isPending": true,
    "outRef": {
      "txHash": "text",
      "outputIndex": 1
    },
    "version": 1
  }
]
PreviousPositionsNextModels