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

# Sviluppatori

> Dove trovare il riferimento API, le guide di integrazione, gli SDK, gli strumenti per la testnet e il codice sorgente per costruire su Intention.

Tutto ciò che serve per costruire su Intention si trova in uno dei posti qui sotto. Questa pagina è la mappa.

Se stai integrando per la prima volta, parti dalla **guida all'integrazione**: va dall'installazione di un SDK fino a un ordine eseguito sulla testnet. Se hai già chiaro com'è fatto il sistema e ti serve solo il dettaglio dei singoli campi, vai direttamente al **riferimento API**.

<h2 id="start-here">
  Da dove iniziare
</h2>

<CardGroup cols={2}>
  <Card title="Guida all'integrazione" icon="book-open" href="https://dev.intention.xyz/">
    Il percorso completo per lo sviluppatore: installazione, autenticazione e firma, avvio rapido REST, conti, dati di mercato, ordini, flusso di trading, trasferimenti USDC e rate limit.
  </Card>

  <Card title="Riferimento API" icon="plug" href="https://testnet-openapi.intention.xyz/">
    La specifica REST e WebSocket completa, con gli schemi e un esecutore di richieste nel browser.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  Che cosa copre l'API
</h2>

Il riferimento è organizzato in questi gruppi. I conteggi sono gli endpoint della specifica testnet attuale.

| Gruppo           | Che cosa copre                                                                                                                       |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Markets**      | Elenco dei mercati perpetui, book degli ordini, operazioni, candele, tassi di funding                                                |
| **Trading**      | Ordini aperti, esecuzioni, ricerca per client order ID                                                                               |
| **Transactions** | Invio, invio in batch, simulazione, codifica e attesa delle transazioni; stima del gas                                               |
| **Accounts**     | Stato di indirizzi e sotto-indirizzi, posizioni, storico degli ordini, storico delle operazioni, trasferimenti, pagamenti di funding |
| **DEX Config**   | Definizioni dei perpetui e dello spot, configurazione delle commissioni, livelli di leva, associazioni degli agenti                  |
| **Oracle**       | Prezzi certificati per il blocco corrente                                                                                            |
| **Dashboard**    | Valore del conto, serie del P\&L, calendario di trading, riepiloghi                                                                  |
| **Export**       | Esportazione CSV di storico degli ordini, storico delle operazioni e pagamenti di funding                                            |
| **WebSocket**    | Canali di sottoscrizione per book degli ordini, operazioni, ticker, candele, sottoconti, blocchi e transazioni                       |

<h2 id="testnet-tools">
  Strumenti per la testnet
</h2>

Strumenti interattivi per lo sviluppo, tutti ospitati sul sito per sviluppatori.

<CardGroup cols={2}>
  <Card title="Faucet" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Richiedi fondi di test per un conto nuovo.
  </Card>

  <Card title="Ricerca ordini" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Ispeziona lo stato e lo storico di qualsiasi ordine tramite ID.
  </Card>

  <Card title="Tester WebSocket" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    Sottoscrivi i canali live e ispeziona i messaggi grezzi.
  </Card>

  <Card title="Verificatore BCS" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Controlla che una transazione serializzata codifichi ciò che ti aspetti, prima di firmarla.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK e sorgenti
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    SDK ufficiali in TypeScript, Go, Python e C++ — generazione dei conti, firma, costruzione degli ordini e trasferimenti.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    I sorgenti degli SDK, del software dei nodi e delle integrazioni di riferimento.
  </Card>
</CardGroup>

<Note>
  La specifica pubblicata al momento riguarda la testnet. La forma degli endpoint è abbastanza stabile per costruirci sopra, ma considera soggetto a modifiche tutto ciò che non è ancora stato messo alla prova sulla mainnet, finché le note di rilascio della mainnet non dicono il contrario.
</Note>

<h2 id="run-a-node">
  Gestire un nodo
</h2>

La gestione di un nodo **non è aperta**. Il set di validatori è gestito da Intention Labs e da partner invitati, e si entra per approvazione, non per registrazione: non esiste una procedura pubblica di adesione né un binario pubblicato per il download generale.

Se hai bisogno di gestire infrastruttura in proprio, scrivi a `contact@intention.xyz` mettendo **Node operator** nell'oggetto. Vedi [Gestire un nodo](/it/developers/run-a-node) per i ruoli esistenti e che cosa includere.

<Note>
  Quasi tutti i motivi per volere un nodo sono motivi di accesso in lettura — query affidabili, storico, non dipendere dall'indexer di qualcun altro. Sono già coperti dall'API qui sopra e dall'[indexer](/it/protocol/architecture/indexer), senza gestire nulla.
</Note>

<h2 id="getting-help">
  Come ottenere aiuto
</h2>

Domande di integrazione, comportamenti inattesi degli endpoint e accordi commerciali vanno tutti a `contact@intention.xyz` — vedi [Domande su API e integrazioni](/it/help/builder-questions) per che cosa includere.