Fetch Markets / Pools

Why This Endpoint?

Markets/pools answer: "Where can this token be traded, and what are the pool IDs?"

The Vybe markets endpoint provides:

All markets for a specific program (e.g. Orca Whirlpool, Raydium CLMM)
Market ID for use in candles and trade endpoints
Base and quote token mint, symbol, and name
Program name and ID for filtering and display
Pagination via page and limit

Use it to build token pages (“Markets for this token”), DEX explorers, pool pickers for charts, and any flow that needs a list of vetted markets per program.

Endpoint

GET /v4/markets

Replaces: GET /price/markets

Parameters

Parameter	Type	Description
`programAddress`	string	DEX/AMM program public key (required)
`limit`	number	Max markets per page. Default/max as per API
`page`	number	Page number (0-indexed)

Example Request

curl "https://api.vybenetwork.com/v4/markets?programAddress=whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "marketId": "15FXRDw7HqPYydehjQRTb8XyV8mPSjdVy1RNacioZaX",
      "marketName": "wSOL-GANG",
      "programId": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
      "programName": "Orca Whirlpool",
      "baseTokenSymbol": "wSOL",
      "quoteTokenSymbol": "GANG",
      "baseTokenMint": "So11111111111111111111111111111111111111112",
      "quoteTokenMint": "d4VVNcnhYwenMzJJk7QgZsxVbLQSijPSLB8m7gKMGFM",
      "baseTokenName": "Wrapped SOL",
      "quoteTokenName": "THUG LIFE",
      "updatedAt": 1740007848
    },
    {
      "marketId": "1XqaaX74LGuQns7cj7FyiMkX1bNXnKfCtFdBoAehuJY",
      "marketName": "wSOL-MON",
      "programId": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
      "programName": "Orca Whirlpool",
      "baseTokenSymbol": "wSOL",
      "quoteTokenSymbol": "MON",
      "baseTokenMint": "So11111111111111111111111111111111111111112",
      "quoteTokenMint": "7KacCvNW1yuJoVjawFyXATaCCsLFWK6KmwCdiH5bjuKb",
      "baseTokenName": "Wrapped SOL",
      "quoteTokenName": "MON Protocol",
      "updatedAt": 1732838746
    }
  ]
}

Response Fields Explained

Field	Description
`marketId`	Unique market/pool ID—use for candles and trade history
`marketName`	Human-readable pair name (e.g. wSOL-GANG)
`programId`	Program public key (DEX/AMM)
`programName`	Program display name (e.g. Orca Whirlpool)
`baseTokenSymbol` / `quoteTokenSymbol`	Base and quote tickers
`baseTokenMint` / `quoteTokenMint`	Base and quote mint addresses
`baseTokenName` / `quoteTokenName`	Full token names
`updatedAt`	Last update time (unix timestamp)

Common Use Cases

Use Case	Implementation
Token page “Markets”	Call with each supported program, filter client-side by base/quote mint
Pool selector for charts	List markets for one program, then call Market Candles with chosen `marketId`
DEX explorer	Paginate through markets for a program, show name and tokens
Routing / liquidity	Enumerate markets to know which pools exist for a given token
Research	See which programs and pairs are indexed by Vybe

Best Practices

Use the right program ID

Get program IDs from Available DEXs & AMMs. Example program IDs:

Orca Whirlpool: whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc
Raydium CLMM: CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK
Phoenix: PhoeNiXZ8ByJGLkxNfZRnkUfjvmuYqLR89jjFHGqdXY

Find markets for a token

Request markets for one or more programs, then filter data where baseTokenMint or quoteTokenMint equals your token mint.

Paginate for large lists

Use limit and page to walk through all markets when a program has many pools.

Related Endpoints

Available DEXs & AMMs – List of supported programs and addresses
Token Candles – Aggregated OHLC for a token across markets
Market Price Candles – OHLC for a single market/pool
Token Details & Metrics – Token info to pair with market list