Data Fetching

Retrieve information about positions, limit orders, and pool details

Get user perpetual positions

get
/api/perpetuals/getPositions

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
/api/perpetuals/getPositions
GET /api/perpetuals/getPositions?address=text 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

get
/api/perpetuals/getPoolInfo

Retrieves cached pool information for perpetual trading pools.

Responses
200

Successfully retrieved pool information

application/json
get
/api/perpetuals/getPoolInfo
GET /api/perpetuals/getPoolInfo HTTP/1.1
Host: app.strikefinance.org
Accept: */*
{
  "data": [
    {
      "totalAssetAmount": 1,
      "availableAssetAmount": 1,
      "totalLpMinted": 1,
      "totalValueLocked": 1
    }
  ]
}

Get UTXO ratios data

get
/api/perpetuals/ratios

Retrieves cached UTXO ratio data for different time periods (daily, weekly, monthly, half-year, yearly).

Responses
200

Successfully retrieved ratios data

application/json
get
/api/perpetuals/ratios
GET /api/perpetuals/ratios HTTP/1.1
Host: app.strikefinance.org
Accept: */*
{
  "daily": {
    "ADA": {
      "initialRatio": 1,
      "currentRatio": 1
    },
    "SNEK": {
      "initialRatio": 1,
      "currentRatio": 1
    }
  },
  "weekly": {
    "ADA": {
      "initialRatio": 1,
      "currentRatio": 1
    },
    "SNEK": {
      "initialRatio": 1,
      "currentRatio": 1
    }
  },
  "monthly": {
    "ADA": {
      "initialRatio": 1,
      "currentRatio": 1
    },
    "SNEK": {
      "initialRatio": 1,
      "currentRatio": 1
    }
  },
  "halfYear": {
    "ADA": {
      "initialRatio": 1,
      "currentRatio": 1
    },
    "SNEK": {
      "initialRatio": 1,
      "currentRatio": 1
    }
  },
  "yearly": {
    "ADA": {
      "initialRatio": 1,
      "currentRatio": 1
    },
    "SNEK": {
      "initialRatio": 1,
      "currentRatio": 1
    }
  },
  "lastUpdated": 1
}

Get Limit Orders

get
/api/perpetuals/getLimitOrders

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
/api/perpetuals/getLimitOrders
GET /api/perpetuals/getLimitOrders?address=addr1q... 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
  }
]

Get perpetual trading parameters for all assets

get
/api/perpetuals/getParams

Retrieves hourly fees, opening fees, maximum position size, and other parameters for all available assets

Responses
200

Successfully retrieved fee parameters for all assets

application/json
get
/api/perpetuals/getParams
GET /api/perpetuals/getParams HTTP/1.1
Host: app.strikefinance.org
Accept: */*
[
  {
    "symbol": "ADA",
    "asset": {
      "policyId": "text",
      "assetName": "text"
    },
    "longHourlyFee": 0.0001,
    "shortHourlyFee": 0.00015,
    "longOpeningFee": 0.005,
    "shortOpeningFee": 0.0055,
    "maxPositionSizeUSD": 100000,
    "maxLeverage": 10,
    "utilizationRate": 65.5
  }
]

Get overall market information

get
/api/perpetuals/getOverallInfo

Retrieves comprehensive market information for all perpetual trading assets.

Responses
200

Successfully retrieved overall market information

application/json
get
/api/perpetuals/getOverallInfo
GET /api/perpetuals/getOverallInfo HTTP/1.1
Host: app.strikefinance.org
Accept: */*
{
  "data": [
    {
      "symbol": "ADA",
      "longInterest": 1,
      "shortInterest": 1
    }
  ]
}