REST

REST endpoints for protocol information.

Tickers

To retrieve the latest price information for pricing display:

• CELO URL: https://api.perpex.ai/prices/tickers

Candlesticks

To retrieve candlesticks data:

• CELO URL: https://api.perpex.ai/prices/candles?tokenSymbol=GBPm&period=1d

Required query parameters:

• tokenSymbol

• period: 1m, 5m, 15m, 1h, 4h, or 1d

Optional query parameters:

• limit: The maximum number of candles to return. Defaults to 1000 if not specified.

  • Minimum: 1

  • Maximum: 10000

Response format:

{
  "period": "1d",
  "candles": [
    [1701388800, 2150.25, 2180.5, 2145.0, 2175.3],
    [1701302400, 2120.1, 2155.0, 2110.0, 2150.25]
  ]
}

Each candle is an array with 5 values:

1. timestamp - Unix timestamp (seconds) of the candle period start

2. open - Opening price

3. high - Highest price during the period

4. low - Lowest price during the period

5. close - Closing price

Candles are returned in descending order (most recent first).

Fee APYs

To retrieve PX fee APYs:

• CELO URL: https://api.perpex.ai/pool/apy

Accepted query parameters:

• period: 1d, 7d, 30d, 90d, 180d, 1y, total. If no period is set, 30d is returned by default.

Performance

To retrieve PX annualized performance:

• CELO URL: https://api.perpex.ai/pool/annualized

Accepted query parameters:

• period: 7d, 30d, 90d, 180d, 1y, total. If no period is set, 90d is returned by default.

• address: The address of a specific GM or GLV if data for only one entity is required.