API Perps

Raydium Perps API v1

Public REST API providing market data and protocol information for Raydium Perpetuals.

This API is used by the Raydium Perps UI to fetch information about markets, prices, and protocol state.

---

Base URL

https://api-perps-v1.raydium.io

Swagger UI

https://api-perps-v1.raydium.io/docs

---

Response Format

Most endpoints return JSON objects containing market or protocol information.

Example response

{
  "success": true,
  "data": {}
}

---

Data available

Data	Use case
Market list	Display supported perps
Funding rates	Funding analytics
Orderbook	Trading UI
Trade history	Market analytics

---

MAIN

General protocol information.

---

GET /main/info

Returns general information about the Perps protocol.

GET /main/info

Response

{
  "tvl": number,
  "volume24h": number,
  "markets": number
}

Field	Description
tvl	Total value locked in the protocol
volume24h	24h trading volume
markets	Number of active markets

---

GET /main/markets

Returns the list of perpetual markets supported by Raydium.

GET /main/markets

Response

[
  {
    "symbol": "string",
    "baseAsset": "string",
    "quoteAsset": "string",
    "price": number,
    "fundingRate": number
  }
]

Field	Description
symbol	Market symbol
baseAsset	Base token
quoteAsset	Quote token
price	Current index price
fundingRate	Current funding rate

---

MARKETS

Market data endpoints.

---

GET /markets/info

Returns detailed information about a specific market.

Query Parameters

Parameter	Required	Description
symbol	yes	market symbol

Example

GET /markets/info?symbol=SOL-PERP

---

GET /markets/orderbook

Returns the orderbook for a market.

Query Parameters

Parameter	Required
symbol	yes

Response

{
  "bids": [],
  "asks": []
}

---

GET /markets/trades

Returns recent trades for a market.

Query Parameters

Parameter	Required
symbol	yes

---

FUNDING

Funding rate information for perpetual markets.

---

GET /funding/rates

Returns funding rates for all markets.

GET /funding/rates

Response

[
  {
    "symbol": "string",
    "fundingRate": number,
    "nextFundingTime": number
  }
]

Field	Description
symbol	market symbol
fundingRate	current funding rate
nextFundingTime	timestamp of next funding event