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

# Developers

> Where to find the API reference, integration guides, SDKs, testnet tools, and source code for building on Intention.

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

<CardGroup cols={2}>
  <Card title="Integration guide" icon="book-open" href="https://dev.intention.xyz/">
    The full developer walkthrough: installation, authentication and signing, REST quick start, accounts, market data, orders, trading flow, USDC transfers, and rate limits.
  </Card>

  <Card title="API reference" icon="plug" href="https://testnet-openapi.intention.xyz/">
    The complete REST and WebSocket specification with schemas and an in-browser request runner.
  </Card>
</CardGroup>

## What the API covers

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

| Group            | What it covers                                                                                        |
| ---------------- | ----------------------------------------------------------------------------------------------------- |
| **Markets**      | Perpetual market list, order books, trades, candles, funding rates                                    |
| **Trading**      | Open orders, fills, lookup by client order ID                                                         |
| **Transactions** | Submit, batch-submit, simulate, encode, and wait on transactions; gas estimation                      |
| **Accounts**     | Address and sub-address state, positions, order history, trade history, transfers, funding payments   |
| **DEX Config**   | Perpetual and spot definitions, fee configuration, leverage tiers, agent bindings                     |
| **Oracle**       | Certified prices for the current block                                                                |
| **Dashboard**    | Account value, PnL series, trading calendar, summaries                                                |
| **Export**       | CSV export for order history, trade history, and funding payments                                     |
| **WebSocket**    | Subscription channels for order book, trades, ticker, candles, sub-accounts, blocks, and transactions |

## Testnet tools

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

<CardGroup cols={2}>
  <Card title="Faucet" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Claim testnet funds for a new account.
  </Card>

  <Card title="Order lookup" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Inspect the status and history of any order by ID.
  </Card>

  <Card title="WebSocket tester" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    Subscribe to live channels and inspect raw messages.
  </Card>

  <Card title="BCS verifier" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Check that a serialized transaction encodes what you expect before signing it.
  </Card>
</CardGroup>

## SDKs and source

<CardGroup cols={2}>
  <Card title="SDKs" icon="cubes" href="https://dev.intention.xyz/installation">
    Official SDKs in TypeScript, Go, Python, and C++ — account generation, signing, order construction, and transfers.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    Source for the SDKs, node software, and reference integrations.
  </Card>
</CardGroup>

<Note>
  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.
</Note>

## 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](/developers/run-a-node) for the roles that exist and what to include.

<Note>
  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](/protocol/architecture/indexer), without operating anything.
</Note>

## Getting help

Integration questions, unexpected endpoint behavior, and commercial arrangements all go to `contact@intention.xyz` — see [Builder and integration questions](/help/builder-questions) for what to include.