Pools

Pool data, keys, liquidity history, and CLMM position data.

Pool Info

get

Get pool info by pool ID.

Query parameters

idsstringRequired

Comma-separated IDs.

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/info/ids

HTTPcURLJavaScriptPython

GET /pools/info/ids?ids=text HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Info by LP Mint

get

Get pool info by LP mint.

Query parameters

lpsstringRequired

lp.join(',')

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/info/lps

HTTPcURLJavaScriptPython

GET /pools/info/lps?lps=text HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Info List

get

Get a paginated list of pools.

Query parameters

poolTypestring · enumRequired

pool type

Possible values:

poolSortFieldstring · enumRequired

pool field

Possible values:

sortTypestring · enumRequired

sort type

Possible values:

pageSizenumberRequired

page size, max 1000

pagenumberRequired

Page index.

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/info/list

HTTPcURLJavaScriptPython

GET /pools/info/list?poolType=all&poolSortField=default&sortType=desc&pageSize=1&page=1 HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Info by Token Mint

get

Get pools by token mint.

Query parameters

mint1stringRequired

search mint

mint2stringOptional

search mint

poolTypestring · enumRequired

pool type

Possible values:

poolSortFieldstring · enumRequired

pool field

Possible values:

sortTypestring · enumRequired

sort type

Possible values:

pageSizenumberRequired

page size, max 1000

pagenumberRequired

Page index.

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/info/mint

HTTPcURLJavaScriptPython

GET /pools/info/mint?mint1=text&poolType=all&poolSortField=default&sortType=desc&pageSize=1&page=1 HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Info List V2

get

Get the V2 paginated pool list.

Query parameters

poolTypestring · enumOptional

Type of pool. Can be Concentrated or Standard. Optional — if not set, all types are returned.

Possible values:

mintFilterstringOptional

Whether to filter by mint. Optional. please refer /main/mint-filter-config

hasRewardbooleanOptional

Whether to return only pools that have rewards. Optional.

sortFieldstring · enumOptional

Field to sort by. Optional.

Possible values:

sortTypestring · enumOptional

Sorting order, either ascending (asc) or descending (desc). Optional.

Possible values:

sizeinteger · min: 1Required

Number of records to return per page.

nextPageIdstringOptional

The id returned from the previous page, used for pagination. Optional — if not provided, the first page is returned.

mint1stringOptional

Filter for pools that include this mint. Optional.

mint2stringOptional

Filter for pools that include this mint. Optional.

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/info/list-v2

HTTPcURLJavaScriptPython

GET /pools/info/list-v2?size=1 HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Keys

get

Get pool keys by pool ID.

Query parameters

idsstringRequired

Comma-separated IDs.

Responses

200

Successful response.

application/json

object[]Optional

get

/pools/key/ids

HTTPcURLJavaScriptPython

GET /pools/key/ids?ids=text HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

[
  {}
]

Pool Liquidity History

get

Get pool liquidity history for up to 30 days.

Query parameters

idstringRequired

Pool ID.

Responses

200

Successful response.

application/json

countnumberOptional

day

get

/pools/line/liquidity

HTTPcURLJavaScriptPython

GET /pools/line/liquidity?id=text HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

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

CLMM Position History

get

Get CLMM position history for a pool.

Query parameters

idstringRequired

Pool ID.

Responses

200

Successful response.

application/json

countnumberOptional

day

get

/pools/line/position

HTTPcURLJavaScriptPython

GET /pools/line/position?id=text HTTP/1.1
Host: api-v3.raydium.io
Accept: */*

200

Successful response.

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