> ## Documentation Index
> Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Raydium API v3

> API REST para consultar pools de liquidez, mints, farms e dados da blockchain no Raydium do Solana

<Info>
  **Esta página foi traduzida automaticamente por IA. A versão em inglês é a fonte oficial.**

  [Ver versão em inglês →](/api-reference/api-v3/overview)
</Info>

## O que é Raydium API v3?

Raydium API v3 oferece uma interface REST para consultar pools de liquidez, metadados de tokens, farms e estatísticas da blockchain nos venues de trading do Raydium no Solana. Ela é utilizada por wallets, agregadores, roteadores DEX e traders para obter dados canônicos de pools, feeds de preços e análises históricas.

A API foi projetada para alto throughput — as respostas têm tipicamente entre 1–5 minutos de atraso dependendo da sensibilidade do endpoint. Todas as respostas são envolvidas em um envelope consistente com metadados.

## Hosts base

| Ambiente    | URL                                |
| ----------- | ---------------------------------- |
| **Mainnet** | `https://api-v3.raydium.io`        |
| **Devnet**  | `https://api-v3-devnet.raydium.io` |

## Envelope de resposta

Todos os endpoints retornam um envelope JSON com metadados da requisição e o payload da resposta:

### Resposta de sucesso

```json theme={null}
{
  "id": "abc123def456",
  "success": true,
  "data": {
    // dados específicos do endpoint
  }
}
```

### Resposta de erro

```json theme={null}
{
  "id": "abc123def456",
  "success": false,
  "msg": "query ids type error"
}
```

O campo `id` é um identificador único de requisição (UUID). Sempre inspecione `success` antes de processar `data`.

## Armadilhas comuns

### Ordenação de pares de mints em `/pools/info/mint`

Quando você consulta `/pools/info/mint?mint1=ABC&mint2=XYZ`, o endpoint normaliza internamente o par ordenando os mints alfabeticamente. Se você precisa buscar um único mint, omita `mint2` inteiramente — a API encontrará todos os pools que contêm esse mint.

### Valores de filtro de tipo de pool

O parâmetro de query `poolType` aceita valores de enum específicos:

* `all` — todos os tipos de pool
* `concentrated` — apenas pools CLMM
* `standard` — apenas pools AMM (constant-product)
* `allFarm` — pools com pelo menos uma farm ativa
* `concentratedFarm` — pools concentrados com farms
* `standardFarm` — pools standard com farms

Erros de digitação ou incompatibilidades de sensibilidade de maiúsculas serão rejeitados.

### Valores de campo de ordenação de pool

Os valores válidos de `poolSortField` são:

* `default` (ordena por volume 24h)
* `liquidity` (TVL)
* `volume24h`, `volume7d`, `volume30d`
* `fee24h`, `fee7d`, `fee30d`
* `apr24h`, `apr7d`, `apr30d`

### Paginação com `/pools/info/list-v2`

O endpoint v2 utiliza paginação baseada em cursor via `nextPageId`. O token opaco é retornado na resposta e deve ser passado de volta de forma idêntica. Não tente construir seu próprio cursor — ele codifica o estado do Elasticsearch.

### Padrões e limites de tamanho de página

* `/pools/info/list` e `/pools/info/mint` limitam `pageSize` a **1000**.
* `/farms/info/lp` limita `pageSize` a **100**.
* `/pools/info/list-v2` limita `size` a **1000**.

Requisições que excedem os limites são rejeitadas com um erro.

### Configurações dinâmicas de taxa e limite de CLMM

Dois novos endpoints expõem dados de calibração para o fluxo `CreateCustomizablePool` do CLMM:

* `GET /main/clmm-dynamic-config` — lista de tiers de `DynamicFeeConfig` (período de filtro, período de decaimento, fator de redução, numerador máximo, controle de taxa dinâmica). Passe o `id` de um desses ao chamar `createCustomizablePool` quando `enableDynamicFee=true`.
* `GET /main/clmm-limit-order-config` — configuração de limite de pedidos por pool: se limites de pedidos estão habilitados, o valor mínimo de entrada e o `limit_order_admin` off-chain autorizado a liquidar pedidos preenchidos.

Dados de limite de pedidos por wallet (abertos / preenchidos / fechados) ficam na Temp API; veja [`api-reference/temp-api-v1/overview`](/pt/api-reference/temp-api-v1/overview).

## Documentação relacionada

* [Visão geral da API REST](/pt/sdk-api/rest-api)
* [Referência de API](/pt/api-reference)
* [Guia de integração para agregadores](/pt/integration-guides/aggregator)

## Exemplo de uso

**Obter estatísticas principais:**

```bash theme={null}
curl -s https://api-v3.raydium.io/main/info | jq .
```

**Listar os 10 principais pools por TVL:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/list?poolType=all&poolSortField=liquidity&sortType=desc&pageSize=10&page=1' | jq .
```

**Obter pools SOL-USDC:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/pools/info/mint?mint1=So11111111111111111111111111111111111111112&mint2=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&poolType=all&poolSortField=liquidity&sortType=desc&pageSize=5&page=1' | jq .
```

**Obter preços de mints:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/mint/price?mints=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v,4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R' | jq .
```

**Obter pools de farm para um token LP:**

```bash theme={null}
curl -s 'https://api-v3.raydium.io/farms/info/lp?lp=<lp_mint>&pageSize=10&page=1' | jq .
```

## Status e disponibilidade

A Raydium API v3 está ativa na mainnet. Para disponibilidade e incidentes, siga [@Raydium](https://x.com/Raydium).