Stats

Endpoints to fetch statistics

get

Retrieve liquidations records, with optional pagination. Results are ordered from newest to oldest, with up to 20 unique liquidations per request.

Note: This endpoint provides records for the last 31 days.

Responses

200

Default Response

application/json

get

/stats/liquidations

GET /stats/liquidations HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "stats": null,
  "records": [
    {
      "ts": 1,
      "txSig": "text",
      "txSigIndex": 1,
      "slot": 1,
      "liquidationType": "text",
      "user": "text",
      "liquidator": "text",
      "marginRequirement": "text",
      "totalCollateral": "text",
      "marginFreed": "text",
      "liquidationId": "text",
      "bankrupt": true,
      "canceledOrderIds": [
        "text"
      ],
      "liquidatePerp_marketIndex": 1,
      "liquidatePerp_oraclePrice": "text",
      "liquidatePerp_baseAssetAmount": "text",
      "liquidatePerp_quoteAssetAmount": "text",
      "liquidatePerp_lpShares": "text",
      "liquidatePerp_fillRecordId": "text",
      "liquidatePerp_userOrderId": "text",
      "liquidatePerp_liquidatorOrderId": "text",
      "liquidatePerp_liquidatorFee": "text",
      "liquidatePerp_ifFee": "text",
      "liquidateSpot_assetMarketIndex": 1,
      "liquidateSpot_assetPrice": "text",
      "liquidateSpot_assetTransfer": "text",
      "liquidateSpot_liabilityMarketIndex": 1,
      "liquidateSpot_liabilityPrice": "text",
      "liquidateSpot_liabilityTransfer": "text",
      "liquidateSpot_ifFee": "text",
      "liquidateBorrowForPerpPnl_perpMarketIndex": 1,
      "liquidateBorrowForPerpPnl_marketOraclePrice": "text",
      "liquidateBorrowForPerpPnl_pnlTransfer": "text",
      "liquidateBorrowForPerpPnl_liabilityMarketIndex": 1,
      "liquidateBorrowForPerpPnl_liabilityPrice": "text",
      "liquidateBorrowForPerpPnl_liabilityTransfer": "text",
      "liquidatePerpPnlForDeposit_perpMarketIndex": 1,
      "liquidatePerpPnlForDeposit_marketOraclePrice": "text",
      "liquidatePerpPnlForDeposit_pnlTransfer": "text",
      "liquidatePerpPnlForDeposit_assetMarketIndex": 1,
      "liquidatePerpPnlForDeposit_assetPrice": "text",
      "liquidatePerpPnlForDeposit_assetTransfer": "text",
      "perpBankruptcy_marketIndex": 1,
      "perpBankruptcy_pnl": "text",
      "perpBankruptcy_ifPayment": "text",
      "perpBankruptcy_clawbackUser": "text",
      "perpBankruptcy_clawbackUserPayment": "text",
      "perpBankruptcy_cumulativeFundingRateDelta": "text",
      "spotBankruptcy_marketIndex": 1,
      "spotBankruptcy_borrowAmount": "text",
      "spotBankruptcy_ifPayment": "text",
      "spotBankruptcy_cumulativeDepositInterestDelta": "text"
    }
  ],
  "meta": {
    "nextPage": "text"
  }
}

get

Retrieve bankruptcy records, with optional pagination. Results are ordered from newest to oldest, with up to 20 unique bankruptcy per request.

Note: This endpoint provides records for the last 31 days.

Responses

200

Default Response

application/json

get

/stats/bankruptcies

GET /stats/bankruptcies HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "stats": {
    "totalAmount": "text",
    "ifPayment": "text",
    "socialLoss": "text",
    "totalCount": "text"
  },
  "records": [
    {
      "ts": 1,
      "txSig": "text",
      "txSigIndex": 1,
      "slot": 1,
      "liquidationType": "text",
      "user": "text",
      "liquidator": "text",
      "marginRequirement": "text",
      "totalCollateral": "text",
      "marginFreed": "text",
      "liquidationId": "text",
      "bankrupt": true,
      "canceledOrderIds": [
        "text"
      ],
      "liquidatePerp_marketIndex": 1,
      "liquidatePerp_oraclePrice": "text",
      "liquidatePerp_baseAssetAmount": "text",
      "liquidatePerp_quoteAssetAmount": "text",
      "liquidatePerp_lpShares": "text",
      "liquidatePerp_fillRecordId": "text",
      "liquidatePerp_userOrderId": "text",
      "liquidatePerp_liquidatorOrderId": "text",
      "liquidatePerp_liquidatorFee": "text",
      "liquidatePerp_ifFee": "text",
      "liquidateSpot_assetMarketIndex": 1,
      "liquidateSpot_assetPrice": "text",
      "liquidateSpot_assetTransfer": "text",
      "liquidateSpot_liabilityMarketIndex": 1,
      "liquidateSpot_liabilityPrice": "text",
      "liquidateSpot_liabilityTransfer": "text",
      "liquidateSpot_ifFee": "text",
      "liquidateBorrowForPerpPnl_perpMarketIndex": 1,
      "liquidateBorrowForPerpPnl_marketOraclePrice": "text",
      "liquidateBorrowForPerpPnl_pnlTransfer": "text",
      "liquidateBorrowForPerpPnl_liabilityMarketIndex": 1,
      "liquidateBorrowForPerpPnl_liabilityPrice": "text",
      "liquidateBorrowForPerpPnl_liabilityTransfer": "text",
      "liquidatePerpPnlForDeposit_perpMarketIndex": 1,
      "liquidatePerpPnlForDeposit_marketOraclePrice": "text",
      "liquidatePerpPnlForDeposit_pnlTransfer": "text",
      "liquidatePerpPnlForDeposit_assetMarketIndex": 1,
      "liquidatePerpPnlForDeposit_assetPrice": "text",
      "liquidatePerpPnlForDeposit_assetTransfer": "text",
      "perpBankruptcy_marketIndex": 1,
      "perpBankruptcy_pnl": "text",
      "perpBankruptcy_ifPayment": "text",
      "perpBankruptcy_clawbackUser": "text",
      "perpBankruptcy_clawbackUserPayment": "text",
      "perpBankruptcy_cumulativeFundingRateDelta": "text",
      "spotBankruptcy_marketIndex": 1,
      "spotBankruptcy_borrowAmount": "text",
      "spotBankruptcy_ifPayment": "text",
      "spotBankruptcy_cumulativeDepositInterestDelta": "text"
    }
  ],
  "meta": {
    "nextPage": "text"
  }
}

get

Responses

200

Default Response

application/json

get

/stats/vaults

GET /stats/vaults HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "vaults": [
    {
      "pubkey": "text",
      "manager": "text",
      "tokenAccount": "text",
      "userStats": "text",
      "user": "text",
      "delegate": "text",
      "liquidationDelegate": "text",
      "userShares": "text",
      "totalShares": "text",
      "sharesBase": "text",
      "lastFeeUpdateTs": 1,
      "liquidationStartTs": 1,
      "redeemPeriod": 1,
      "initTs": 1,
      "totalWithdrawRequested": 1,
      "maxTokens": "text",
      "netDeposits": "text",
      "totalDeposits": "text",
      "totalWithdraws": "text",
      "managerNetDeposits": "text",
      "managerTotalDeposits": "text",
      "managerTotalWithdraws": "text",
      "managerTotalFee": "text",
      "managerTotalProfitShare": "text",
      "lastManagerWithdrawRequest": {
        "shares": "text",
        "value": "text",
        "ts": "text"
      },
      "minDepositAmount": "text",
      "profitShare": "text",
      "managementFee": "text",
      "hurdleRate": "text",
      "spotMarketIndex": 1,
      "permissioned": true
    }
  ]
}

get

Responses

200

Default Response

application/json

get

/stats/insuranceFundSwaps

GET /stats/insuranceFundSwaps HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "records": [
    {
      "ts": 1,
      "txSig": "text",
      "txSigIndex": 1,
      "slot": 1,
      "inMarketIndex": 1,
      "outMarketIndex": 1,
      "inAmount": "text",
      "outAmount": "text",
      "inVaultAmountBefore": "text",
      "outVaultAmountBefore": "text",
      "inFundVaultAmountAfter": "text",
      "outFundVaultAmountAfter": "text",
      "inIfTotalSharesBefore": "text",
      "outIfTotalSharesBefore": "text",
      "inIfTotalSharesAfter": "text",
      "outIfTotalSharesAfter": "text",
      "inIfUserSharesBefore": "text",
      "outIfUserSharesBefore": "text",
      "inIfUserSharesAfter": "text",
      "outIfUserSharesAfter": "text",
      "outOraclePrice": "text",
      "outOraclePriceTwap": "text",
      "rebalanceConfig": "text"
    }
  ],
  "meta": {
    "nextPage": "text"
  }
}

get

Get rolling market volume data for specified interval

Path parameters

intervalstring · enumRequiredDefault: 24hPossible values:

Responses

200

Default Response

application/json

get

/stats/markets/volume/{interval}

GET /stats/markets/volume/{interval} HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "total": "text",
  "markets": [
    {
      "symbol": "text",
      "quoteVolume": "text",
      "baseVolume": "text",
      "marketIndex": 1,
      "marketType": "text"
    }
  ]
}

get

Get historical market volume data bucketed into 1-hour intervals. Time range must be between 1 and 24 hours (rounded down to nearest hour).

Query parameters

startTsnumberRequired

Start timestamp in seconds (Unix epoch)

endTsnumberRequired

End timestamp in seconds (Unix epoch)

Responses

200

Default Response

application/json

get

/stats/markets/volume

GET /stats/markets/volume?startTs=1&endTs=1 HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "total": "text",
  "startTs": 1,
  "endTs": 1,
  "markets": [
    {
      "symbol": "text",
      "baseVolume": "text",
      "quoteVolume": "text",
      "marketIndex": 1,
      "marketType": "text"
    }
  ]
}

get

Get the 24-hour price change and percentage change for all markets.

Responses

200

Default Response

application/json

get

/stats/markets/prices

GET /stats/markets/prices HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "markets": [
    {
      "symbol": "text",
      "currentPrice": "text",
      "price24hAgo": "text",
      "priceChange": "text",
      "priceChangePercent": "text",
      "marketIndex": 1,
      "marketType": "text"
    }
  ]
}

get

Path parameters

symbolstringRequired

typestring · enumRequiredDefault: depositPossible values:

Responses

200

Default Response

application/json

get

/stats/{symbol}/rateHistory/{type}

GET /stats/{symbol}/rateHistory/{type} HTTP/1.1
Host: 
Accept: */*

200

Default Response

{
  "success": true,
  "rates": [
    [
      1
    ]
  ]
}

get

Get leaderboard entries with optional date and market filters.

Query parameters

pageinteger · min: 1OptionalDefault: 1

limitinteger · min: 1 · max: 100OptionalDefault: 100

sortstring · enumOptionalDefault: pnlPossible values:

startstringOptional

UTC date string YYYY-MM-DD

endstringOptional

UTC date string YYYY-MM-DD

symbolstringOptional

Responses

200

Default Response

No content

get

/stats/leaderboard

GET /stats/leaderboard HTTP/1.1
Host: 
Accept: */*

200

Default Response

No content

get

Get leaderboard rank and stats for a specific user.

Path parameters

authoritystringRequired

Query parameters

startstringOptional

UTC date string YYYY-MM-DD. Defaults to 7 Days prior

endstringOptional

UTC date string YYYY-MM-DD. Defaults to today

symbolstringOptional

Responses

200

Default Response

No content

get

/stats/leaderboard/{authority}

GET /stats/leaderboard/{authority} HTTP/1.1
Host: 
Accept: */*

200

Default Response

No content

PreviousMarket NextAMM

Last updated 1 month ago