Skip to main content
GET
/
pools
/
groups
Groups
curl --request GET \
  --url https://damm-v2.datapi.meteora.ag/pools/groups
{
  "current_page": 1,
  "data": [
    {
      "group_name": "<string>",
      "has_farm": true,
      "lexical_order_mints": "<string>",
      "max_farm_apr": 123,
      "max_fee_tvl_ratio": 123,
      "pool_count": 1,
      "token_x": "<string>",
      "token_y": "<string>",
      "total_tvl": 123,
      "total_volume": 123
    }
  ],
  "page_size": 1,
  "pages": 1,
  "total": 1
}

Query Parameters

​
page
integer | null

Page number (1-based)

Required range: x >= 1
​
page_size
integer | null

Number of pools to return per page. Max 100

Required range: 1 <= x <= 100
​
query
string | null

Search query used to match pools by name, tokens, or address

​
sort_by
string | null

Sort results by one or more fields

Format:

  • Time-windowed metrics: <metric>_<window>:<direction>

  • Non-windowed metrics: <field>:<direction>

  • direction: asc or desc

  • window (when applicable): 5m 30m 1h 2h 4h 12h 24h

Available fields:

  • Time-windowed metrics: volume_* fee_* fee_tvl_ratio_* apr_*
  • Non-windowed metrics: tvl fee_pct bin_step pool_created_at farm_apy

Default: volume_24h:desc

Examples:

  • volume_24h:desc
  • fee_1h:asc
  • tvl:desc
​
filter_by
string | null

Conditions to filter documents by field values

Format: <expr> [&& <expr> ...]

Where each expression is: <field><op><value>

Allowed fields:

  • Numeric: tvl volume_* fee_* fee_tvl_ratio_* apr_*
  • Boolean: is_blacklisted
  • Text: pool_address name token_x token_y

Operators:

  • Numeric: = > >= < <=
  • Boolean: =true =false
  • Text:
    • exact match: =<value>
    • multi-value OR: =[value1|value2|...]

Notes:

  • Multiple expressions are combined using logical AND (&&)
  • Whitespace around operators is ignored

Examples:

  • tvl>1000
  • is_blacklisted=false && volume_24h>=50000
​
volume_tw
string | null
default:volume_24h

Time window to aggregate volume. Returns sum

​
fee_tvl_ratio_tw
string | null
default:fee_tvl_ratio_24h

Time window to aggregate fee tvl ratio. Returns Max

Response

​
current_page
integer<int64>
required
Required range: x >= 0
​
data
object[]
required
​
page_size
integer<int64>
required
Required range: x >= 0
​
pages
integer<int64>
required
Required range: x >= 0
​
total
integer<int64>
required
Required range: x >= 0