Skip to main content
GET
/
pools
/
groups
/
{lexical_order_mints}
Group
curl --request GET \
  --url https://damm-v2.datapi.meteora.ag/pools/groups/{lexical_order_mints}
{
  "current_page": 1,
  "data": [
    {
      "address": "<string>",
      "alpha_vault": "<string>",
      "created_at": 1,
      "current_price": 123,
      "farm_apr": 123,
      "farm_apy": 123,
      "fee_tvl_ratio": {
        "12h": 123,
        "1h": 123,
        "24h": 123,
        "2h": 123,
        "30m": 123,
        "4h": 123
      },
      "fees": {
        "12h": 123,
        "1h": 123,
        "24h": 123,
        "2h": 123,
        "30m": 123,
        "4h": 123
      },
      "has_farm": true,
      "is_blacklisted": true,
      "name": "<string>",
      "permanent_lock_liquidity": 123,
      "pool_config": {
        "activation_point": 1,
        "activation_type": 1,
        "base_fee_mode": 1,
        "base_fee_pct": 123,
        "collect_fee_mode": 1,
        "concentrated_liquidity": true,
        "dynamic_fee_initialized": true,
        "max_price": 123,
        "min_price": 123,
        "partner_fee_pct": 1,
        "pool_type": 1,
        "protocol_fee_pct": 1,
        "referral_fee_pct": 1
      },
      "protocol_fees": {
        "12h": 123,
        "1h": 123,
        "24h": 123,
        "2h": 123,
        "30m": 123,
        "4h": 123
      },
      "tags": [
        "<string>"
      ],
      "token_x": {
        "address": "<string>",
        "decimals": 1,
        "freeze_authority_disabled": true,
        "holders": 123,
        "is_verified": true,
        "market_cap": 123,
        "name": "<string>",
        "price": 123,
        "symbol": "<string>",
        "total_supply": 123
      },
      "token_x_amount": 123,
      "token_y": {
        "address": "<string>",
        "decimals": 1,
        "freeze_authority_disabled": true,
        "holders": 123,
        "is_verified": true,
        "market_cap": 123,
        "name": "<string>",
        "price": 123,
        "symbol": "<string>",
        "total_supply": 123
      },
      "token_y_amount": 123,
      "tvl": 123,
      "vault_x": "<string>",
      "vault_y": "<string>",
      "vested_liquidity": {
        "months_3": 123,
        "months_6": 123
      },
      "volume": {
        "12h": 123,
        "1h": 123,
        "24h": 123,
        "2h": 123,
        "30m": 123,
        "4h": 123
      },
      "launchpad": "<string>"
    }
  ],
  "page_size": 1,
  "pages": 1,
  "total": 1
}

Path Parameters

lexical_order_mints
string
required

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

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