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

# Referência de API

> Catálogo de todas as APIs HTTP operadas pela Raydium: dados de pools, construção de transações, perps, serviços de fórum / mint / histórico / autenticação do LaunchLab, gateway IPFS, posições do proprietário e a API Python legada. Os endpoints listados abaixo abrem um playground interativo.

<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/index)
</Info>

<Info>
  Todo endpoint neste site possui um painel **Try it** (Experimente) alimentado pelo playground OpenAPI do Mintlify. O playground roda no seu navegador e acessa diretamente os hosts de produção (ou devnet) em tempo real. Leia [Autenticação](#autenticação) antes de enviar requisições que exigem assinatura de carteira.
</Info>

## Catálogo de serviços

A Raydium opera onze serviços HTTP públicos. Cada um é documentado como seu próprio grupo na árvore de navegação à esquerda.

| Serviço                                                               | Host Mainnet                   | Host Devnet                           | O que faz                                                                                                                                   |
| --------------------------------------------------------------------- | ------------------------------ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [API v3](/pt/api-reference/api-v3/overview)                           | `api-v3.raydium.io`            | `api-v3-devnet.raydium.io`            | Pool / mint / config / chain-info — a API de leitura canônica em que a UI e o SDK se baseiam.                                               |
| [Transaction API](/pt/api-reference/route-api-v2/overview)            | `transaction-v1.raydium.io`    | `transaction-v1-devnet.raydium.io`    | Construção de transações de swap / liquidez no lado do servidor. O ponto de entrada do agregador.                                           |
| [Perps API](/pt/api-reference/perp-api-v1/overview)                   | `api-perp-v1.raydium.io`       | —                                     | Configurações, metadados de ativos, seleção de RPC para o front-end do Raydium Perps.                                                       |
| [LaunchLab Mint API](/pt/api-reference/launch-mint-v1/overview)       | `launch-mint-v1.raydium.io`    | `launch-mint-v1-devnet.raydium.io`    | Busca de tokens, índices, placares, metadados por mint para launches do LaunchLab.                                                          |
| [LaunchLab History API](/pt/api-reference/launch-history-v1/overview) | `launch-history-v1.raydium.io` | `launch-history-v1-devnet.raydium.io` | Histórico de transações, agregados de K-line para pools do LaunchLab.                                                                       |
| [LaunchLab Forum API](/pt/api-reference/launch-forum-v1/overview)     | `launch-forum-v1.raydium.io`   | `launch-forum-v1-devnet.raydium.io`   | Comentários, threads, uploads IPFS vinculados a um launch do LaunchLab. Com assinatura de carteira.                                         |
| [LaunchLab Auth API](/pt/api-reference/launch-auth-v1/overview)       | `launch-auth-v1.raydium.io`    | `launch-auth-v1-devnet.raydium.io`    | Emite JWTs `ray-token` de curta duração a partir de uma mensagem assinada por carteira. Obrigatório para chamar a API do fórum.             |
| [Dynamic IPFS API](/pt/api-reference/dynamic-ipfs-v1/overview)        | `dynamic-ipfs.raydium.io`      | `dynamic-ipfs-devnet.raydium.io`      | Regenerador de imagem / metadados de NFT. Alimenta a arte de posição CLMM e outros NFTs on-chain cuja aparência depende de estado dinâmico. |
| [Owner API](/pt/api-reference/owner-api-v1/overview)                  | `owner-v1.raydium.io`          | `owner-v1-devnet.raydium.io`          | Posições por carteira, saldos, recompensas reclamáveis.                                                                                     |
| [API v1](/pt/api-reference/api-v1/overview)                           | `api.raydium.io`               | —                                     | Endpoints v1/v2 legados, mantidos ativo para clientes que ainda não migraram para API v3.                                                   |
| [Temp API](/pt/api-reference/temp-api-v1/overview)                    | `temp-api-v1.raydium.io`       | `temp-api-v1-devnet.raydium.io`       | Zona de espera para endpoints bespoke de curta duração. Atualmente expõe resumos de taxa de criador CPMM. Sujeito a mudanças sem aviso.     |

## Autenticação

A maioria dos serviços é somente leitura e aceita requisições anônimas. Dois padrões aparecem:

* **Handshake assinado por carteira** — obrigatório por `launch-auth-v1` para cunhar um `ray-token`, depois transportado como header `ray-token` por `launch-forum-v1`. Assine uma mensagem Solana ed25519 da forma `time:<unix-seconds>` com sua carteira, envie a assinatura + endereço da carteira para `/request-token` de `launch-auth-v1`, receba um JWT de volta e passe-o como header de requisição `ray-token` em chamadas de fórum subsequentes.
* **Sem autenticação** — todos os outros serviços. Chamadores confiáveis (a UI da Raydium, integradores) acessam os endpoints diretamente via HTTPS.

O playground do Mintlify permite que você cole um `ray-token` no painel de autenticação antes de enviar requisições de fórum; o valor é mantido apenas no seu navegador.

## Limites de taxa

Todos os hosts estão atrás da Cloudflare com limite de taxa progressivo por IP de origem.

Integradores que precisam de limites maiores devem entrar em contato com a equipe da Raydium. Rajadas acima dos limites publicados são retornadas como `HTTP 429` com um header `Retry-After`.

## Envelope de resposta

A maioria dos serviços envolve seus payloads JSON em um envelope uniforme:

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": true,
  "data": { ... }
}
```

Em caso de falha:

```json theme={null}
{
  "id": "uuid-v4-per-request",
  "success": false,
  "msg": "human-readable error string",
  "data": null
}
```

`api-v3` retorna o envelope como `{ "id", "success", "data" }`. Os serviços pump-\* usam helpers `addBorderSuccess` / `addBorderErr` que produzem a mesma forma com `msg` preenchido apenas em erros. Verifique a página de introdução de cada serviço para o envelope exato que ele usa.

## Como usar esta seção

Clique em qualquer endpoint na navegação à esquerda. Você verá:

* O método HTTP, URL completa e host base.
* Parâmetros de requisição com tipos extraídos da especificação OpenAPI.
* Um painel **Try it** que permite definir parâmetros e enviar uma requisição real para mainnet (ou escolher um servidor devnet no dropdown quando disponível).
* A forma de resposta, proveniente de uma resposta ao vivo representativa e do callsite `addBorderSuccess` do código-fonte.

Para acesso no nível SDK — construir transações no cliente, agregar swaps, tipos TypeScript — veja [`sdk-api/typescript-sdk`](/pt/sdk-api/typescript-sdk).

## Ponteiros

* [`sdk-api/rest-api`](/pt/sdk-api/rest-api) — visão geral narrativa da superfície REST, escrita para integradores pela primeira vez.
* [`integration-guides/aggregator`](/pt/integration-guides/aggregator) — como usar a Transaction API junto com pools on-chain.
* [`reference/program-addresses`](/pt/reference/program-addresses) — todo ID de programa retornado por `api-v3` se resolve para um destes.