API v3 Spot

Raydium API v3

Public REST API used by the Raydium UI to fetch protocol data such as pools, tokens, farms and protocol statistics.

Base URL

Mainnet

https://api-v3.raydium.io

Devnet

https://api-v3-devnet.raydium.io

Swagger UI

https://api-v3.raydium.io/docs

https://api-v3-devnet.raydium.io/docs

---

Response Format

All API responses are wrapped in a common envelope.

Success response

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

Failure response

{
  "id": "string",
  "success": false,
  "msg": "error message"
}

---

MAIN

General protocol information.

---

GET /main/version

Returns the current Raydium UI version.

Response

{
  "latest": "string",
  "least": "string"
}

Field	Description
latest	Current UI version
least	Minimum supported UI version

---

GET /main/rpcs

Returns RPC endpoints used by the UI.

GET /main/rpcs

Response

{}

---

GET /main/chain-time

Returns the chain time offset relative to local UTC.

GET /main/chain-time

Response

{
  "offset": 0
}

Field	Description
offset	local utc time − chain time

---

GET /main/info

Returns Raydium protocol statistics.

GET /main/info

Response

{
  "tvl": 0,
  "volume24": 0
}

Field	Description
tvl	Total value locked
volume24	24h trading volume

---

GET /main/stake-pools

Returns RAY staking pools.

GET /main/stake-pools

---

GET /main/migrate-lp

Returns pools recommended for migration.

GET /main/migrate-lp

Response

[
  {
    "name": "string",
    "ammId": "string",
    "lpMint": "string",
    "farmIds": ["string"],
    "clmmId": "string",
    "defaultPriceMin": 0,
    "defaultPriceMax": 0
  }
]

---

GET /main/auto-fee

Returns estimated transaction fee tiers.

GET /main/auto-fee

Response

{
  "default": {
    "m": 0,
    "h": 0,
    "vh": 0
  }
}

Field	Description
m	lower fee
h	moderate fee
vh	higher fee

---

GET /main/clmm-config

Returns CLMM configuration options used when creating pools.

GET /main/clmm-config

Response

[
  {
    "id": "string",
    "index": 0,
    "protocolFeeRate": 0,
    "tradeFeeRate": 0,
    "tickSpacing": 0,
    "fundFeeRate": 0
  }
]

---

GET /main/cpmm-config

Returns CPMM configuration options.

GET /main/cpmm-config

Response

[
  {
    "id": "string",
    "index": 0,
    "protocolFeeRate": 0,
    "tradeFeeRate": 0,
    "fundFeeRate": 0,
    "createPoolFee": "string"
  }
]

---

GET /main/mint-filter-config

Returns UI mint filter configuration.

GET /main/mint-filter-config

---

MINT

Token metadata and prices.

---

GET /mint/list

Returns the default token list used by the Raydium UI.

GET /mint/list

Response

{
  "blockList": ["string"],
  "mintList": []
}

---

GET /mint/ids

Returns metadata for specific tokens.

Query Parameters

Parameter	Required	Description
mints	yes	comma-separated mint addresses

Example

/mint/ids?mints=So11111111111111111111111111111111111111112

---

GET /mint/price

Returns token prices.

Query Parameters

Parameter	Required	Description
mints	no	comma-separated mint addresses

Response

{
  "mintAddress": "price"
}

---

POOLS

Liquidity pool information.

---

GET /pools/info/ids

Returns pool information.

Query Parameters

Parameter	Required	Description
ids	yes	comma-separated pool IDs

Example

/pools/info/ids?ids=pool1,pool2

---

GET /pools/info/lps

Returns pools by LP mint.

Query Parameters

Parameter	Required
lps	yes

---

GET /pools/info/list

Returns paginated pool list.

Query Parameters

Parameter	Description
poolType	all, concentrated, standard
poolSortField	liquidity, volume24h, fee24h, apr24h
sortType	asc / desc
pageSize	number
page	page index

---

GET /pools/info/list-v2

Improved pool list endpoint.

Query Parameters

Parameter	Description
poolType	Concentrated / Standard
mintFilter	token filter
hasReward	return pools with rewards
sortField	liquidity, volume24h, apr
sortType	asc / desc
size	page size
nextPageId	pagination cursor
mint1	token filter
mint2	token filter

---

GET /pools/info/mint

Search pools by token mint.

Query Parameters

Parameter	Required
mint1	yes
mint2	no

---

GET /pools/key/ids

Returns pool account keys.

Query Parameters

Parameter	Required
ids	yes

---

GET /pools/line/liquidity

Returns pool liquidity history.

Query Parameters

Parameter	Required
id	yes

Response

{
  "count": 0,
  "line": [
    {
      "time": 0,
      "liquidity": 0
    }
  ]
}

---

GET /pools/line/position

Returns CLMM position history.

Query Parameters

Parameter	Required
id	yes

Response

{
  "count": 0,
  "line": [
    {
      "price": 0,
      "tick": 0,
      "liquidity": 0
    }
  ]
}

---

FARMS

Farm pool information.

---

GET /farms/info/ids

Returns farm information.

Query Parameters

Parameter	Required
ids	yes

---

GET /farms/info/lp

Returns farms by LP mint.

Query Parameters

Parameter	Required	Description
lp	yes	LP token mint
pageSize	yes	max 100
page	yes	page index

---

GET /farms/key/ids

Returns farm account keys.

Query Parameters

Parameter	Required
ids	yes

---

IDO

IDO pool information.

---

GET /ido/key/ids

Returns IDO pool account keys.

Query Parameters

Parameter	Required
ids	yes