---
updatedAt: 2026-04-07T08:46:45.000Z
agentTools:
  projectIndex: https://docs.vybenetwork.com/llms.txt
---

# Fetch Markets / Pools

List all tradeable markets and liquidity pools for any Solana DEX or AMM. Get market IDs, token pairs and program names for Raydium, Orca, Meteora and more.

Discover all tradable markets across Solana DEXs and AMMs, including pools, order books, and hybrid venues. Retrieve market IDs, base and quote tokens, and associated programs to understand where assets trade and how liquidity is distributed.

This data enables building token market pages, DEX explorers, pool selectors for charts, and routing systems that rely on accurate, program-level market coverage across the Solana ecosystem.

## 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

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

***

## Example Response

```json
{
  "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](https://docs.vybenetwork.com/reference/get_market_filtered_ohlcv_v4) 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](./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](./available-dexs-amms) – List of supported programs and addresses
* [Token Candles](./fetch-candles) – Aggregated OHLC for a token across markets
* [Market Price Candles](https://docs.vybenetwork.com/reference/get_market_filtered_ohlcv_v4) – OHLC for a single market/pool
* [Token Details & Metrics](./token-details-spl-token-2022) – Token info to pair with market list