Data Fetching
Retrieve information about positions, limit orders, and pool details
Retrieves active and pending perpetual positions for a given wallet address.
User's wallet address
List of perpetual positions
Invalid request
Server error
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"
}
]Retrieves cached pool information for perpetual trading pools.
Successfully retrieved pool information
Method not allowed
Internal server error
GET /api/perpetuals/getPoolInfo HTTP/1.1
Host: app.strikefinance.org
Accept: */*
{
"data": [
{
"totalAssetAmount": 1,
"availableAssetAmount": 1,
"totalLpMinted": 1,
"totalValueLocked": 1
}
]
}Retrieves cached UTXO ratio data for different time periods (daily, weekly, monthly, half-year, yearly).
Successfully retrieved ratios data
Method not allowed
Internal server error
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
}Retrieves all limit orders for a specific address, including both on-chain and pending orders.
The Cardano address to get limit orders for
addr1q...Successfully retrieved limit orders
Bad request - Address is required
Method not allowed
Internal server error
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
}
]Retrieves hourly fees, opening fees, maximum position size, and other parameters for all available assets
Successfully retrieved fee parameters for all assets
Method not allowed - only GET requests are supported
Internal server error
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
}
]Retrieves comprehensive market information for all perpetual trading assets.
Successfully retrieved overall market information
Method not allowed - only GET requests are supported
Internal server error
GET /api/perpetuals/getOverallInfo HTTP/1.1
Host: app.strikefinance.org
Accept: */*
{
"data": [
{
"symbol": "ADA",
"longInterest": 1,
"shortInterest": 1
}
]
}