Skip to main content
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.

Começar por aqui

Guia de integração

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.

Referência da API

A especificação completa REST e WebSocket, com esquemas e um executor de pedidos no browser.

O que a API cobre

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

Ferramentas de testnet

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

Faucet

Obter fundos de teste para uma conta nova.

Consulta de ordens

Inspecionar o estado e o histórico de qualquer ordem por ID.

Testador de WebSocket

Subscrever canais em direto e inspecionar as mensagens em bruto.

Verificador BCS

Confirmar que uma transação serializada codifica aquilo que se espera antes de a assinar.

SDKs e código-fonte

SDKs

SDKs oficiais em TypeScript, Go, Python e C++ — geração de contas, assinatura, construção de ordens e transferências.

GitHub

Código-fonte dos SDKs, do software de nó e das integrações de referência.
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.

Operar um nó

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ó para conhecer os papéis existentes e o que incluir.
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, sem ter de operar nada.

Obter ajuda

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 para saber o que incluir.