Skip to main content
GET
/
api
/
holding-rates
/
{collateralIndex}
/
{pairIndex}
Get Holding Rates
curl --request GET \
  --url https://backend-global.gains.trade/api/holding-rates/{collateralIndex}/{pairIndex}
{
  "holdingRates": [
    {}
  ]
}

​
Endpoint

GET /api/holding-rates/{collateralIndex}/{pairIndex} Returns historical borrowing and funding rates for a collateral and pair.

​
Parameters

ParameterLocationRequiredTypeDescription
collateralIndexpathYesintegerCollateral index.
pairIndexpathYesintegerTrading pair index.
chainIdqueryYesintegerBlockchain chain ID. Common values: 42161 Arbitrum, 8453 Base, 137 Polygon.

​
Usage Example

curl -X GET "https://backend-global.gains.trade/api/holding-rates/1/0?chainId=42161"

​
Response Structure

The generated API panel lists the response schema for status codes: 200, 400, 503, 500. Error responses generally return an error or message field.

Path Parameters

​
collateralIndex
integer
required

Collateral index.

Example:

1

​
pairIndex
integer
required

Trading pair index.

Example:

0

Query Parameters

​
chainId
integer
required

Blockchain chain ID. Common values: 42161 Arbitrum, 8453 Base, 137 Polygon.

Example:

42161

Response

Successful response

​
holdingRates
object[]