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

# Programadores

> Onde encontrar a referência da API, os guias de integração, os SDKs, as ferramentas de testnet e o código-fonte para construir na Intention.

Tudo o que é preciso para construir na Intention está num dos sítios abaixo. Esta página é o mapa.

Se está a integrar pela primeira vez, comece pelo **guia de integração** — vai da instalação de um SDK até uma ordem executada na testnet. Se já conhece a forma do sistema e só precisa do detalhe ao nível dos campos, vá diretamente para a **referência da API**.

<h2 id="start-here">
  Começar por aqui
</h2>

<CardGroup cols={2}>
  <Card title="Guia de integração" icon="book-open" href="https://dev.intention.xyz/">
    O percurso completo para programadores: instalação, autenticação e assinatura, arranque rápido em REST, contas, dados de mercado, ordens, fluxo de negociação, transferências de USDC e rate limits.
  </Card>

  <Card title="Referência da API" icon="plug" href="https://testnet-openapi.intention.xyz/">
    A especificação completa REST e WebSocket, com esquemas e um executor de pedidos no browser.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  O que a API cobre
</h2>

A referência está organizada nestes grupos. As contagens referem-se aos endpoints da especificação atual da testnet.

| Grupo          | O que cobre                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Mercados**   | Lista de mercados perpétuos, livros de ordens, transações, velas, taxas de funding                                                |
| **Negociação** | Ordens abertas, execuções, consulta por ID de ordem do cliente                                                                    |
| **Transações** | Submeter, submeter em lote, simular, codificar e aguardar transações; estimativa de gas                                           |
| **Contas**     | Estado de endereços e subendereços, posições, histórico de ordens, histórico de transações, transferências, pagamentos de funding |
| **DEX Config** | Definições de perpétuos e de spot, configuração de comissões, escalões de alavancagem, associações de agente                      |
| **Oráculo**    | Preços certificados para o bloco atual                                                                                            |
| **Dashboard**  | Valor da conta, séries de PnL, calendário de negociação, resumos                                                                  |
| **Exportação** | Exportação CSV do histórico de ordens, do histórico de transações e dos pagamentos de funding                                     |
| **WebSocket**  | Canais de subscrição para livro de ordens, execuções, ticker, velas, subcontas, blocos e transações                               |

<h2 id="testnet-tools">
  Ferramentas de testnet
</h2>

Ferramentas interativas para desenvolvimento, todas alojadas no site para programadores.

<CardGroup cols={2}>
  <Card title="Faucet" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Obter fundos de teste para uma conta nova.
  </Card>

  <Card title="Consulta de ordens" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Inspecionar o estado e o histórico de qualquer ordem por ID.
  </Card>

  <Card title="Testador de WebSocket" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    Subscrever canais em direto e inspecionar as mensagens em bruto.
  </Card>

  <Card title="Verificador BCS" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Confirmar que uma transação serializada codifica aquilo que se espera antes de a assinar.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDKs e código-fonte
</h2>

<CardGroup cols={2}>
  <Card title="SDKs" icon="cubes" href="https://dev.intention.xyz/installation">
    SDKs oficiais em TypeScript, Go, Python e C++ — geração de contas, assinatura, construção de ordens e transferências.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    Código-fonte dos SDKs, do software de nó e das integrações de referência.
  </Card>
</CardGroup>

<Note>
  A especificação publicada visa atualmente a testnet. A forma dos endpoints é suficientemente estável para se construir sobre ela, mas trate como sujeito a alteração tudo o que ainda não tenha sido posto à prova em mainnet, até que as notas de lançamento da mainnet digam o contrário.
</Note>

<h2 id="run-a-node">
  Operar um nó
</h2>

A operação de nós **não está aberta**. O conjunto de validadores é operado pela Intention Labs e por parceiros convidados, e a entrada faz-se por aprovação e não por registo — não existe um processo público de adesão nem um binário publicado para descarregamento geral.

Se precisa de operar infraestrutura, escreva para `contact@intention.xyz` com **Node operator** no assunto. Ver [Operar um nó](/pt/developers/run-a-node) para conhecer os papéis existentes e o que incluir.

<Note>
  A maioria das razões para querer um nó são razões de acesso de leitura — consultas fiáveis, histórico, não depender do indexador de outra pessoa. Essas razões ficam servidas pela API acima e pelo [indexador](/pt/protocol/architecture/indexer), sem ter de operar nada.
</Note>

<h2 id="getting-help">
  Obter ajuda
</h2>

Questões de integração, comportamento inesperado de um endpoint e acordos comerciais vão todos para `contact@intention.xyz` — ver [Questões de integração](/pt/help/builder-questions) para saber o que incluir.