Skip to main content
Everything needed to build on Intention lives in one of the places below. This page is the map. If you are integrating for the first time, start with the integration guide — it walks from installing an SDK to a filled order on testnet. If you already know the shape of the system and just need field-level detail, go straight to the API reference.

Start here

Integration guide

The full developer walkthrough: installation, authentication and signing, REST quick start, accounts, market data, orders, trading flow, USDC transfers, and rate limits.

API reference

The complete REST and WebSocket specification with schemas and an in-browser request runner.

What the API covers

The reference is organized into these groups. Counts are endpoints in the current testnet specification.

Testnet tools

Interactive tools for development, all hosted on the developer site.

Faucet

Claim testnet funds for a new account.

Order lookup

Inspect the status and history of any order by ID.

WebSocket tester

Subscribe to live channels and inspect raw messages.

BCS verifier

Check that a serialized transaction encodes what you expect before signing it.

SDKs and source

SDKs

Official SDKs in TypeScript, Go, Python, and C++ — account generation, signing, order construction, and transfers.

GitHub

Source for the SDKs, node software, and reference integrations.
The published specification currently targets testnet. Endpoint shapes are stable enough to build against, but treat anything not yet exercised on mainnet as subject to change until the mainnet release notes say otherwise.

Run a node

Node operation is not open. The validator set is run by Intention Labs and invited partners, and joining is by approval rather than registration — there is no public join flow and no binary published for general download. If you need to operate infrastructure, email contact@intention.xyz with Node operator in the subject line. See Run a node for the roles that exist and what to include.
Most reasons for wanting a node are read-access reasons — reliable queries, history, not depending on someone else’s indexer. Those are served by the API above and by the indexer, without operating anything.

Getting help

Integration questions, unexpected endpoint behavior, and commercial arrangements all go to contact@intention.xyz — see Builder and integration questions for what to include.