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

# Desarrolladores

> Dónde encontrar la referencia de la API, las guías de integración, los SDK, las herramientas de testnet y el código fuente para construir sobre Intention.

Todo lo necesario para construir sobre Intention está en alguno de los sitios de abajo. Esta página es el mapa.

Si es tu primera integración, empieza por la **guía de integración**: va desde instalar un SDK hasta una orden ejecutada en testnet. Si ya conoces la forma del sistema y solo necesitas el detalle campo por campo, ve directo a la **referencia de la API**.

<h2 id="start-here">
  Empieza aquí
</h2>

<CardGroup cols={2}>
  <Card title="Guía de integración" icon="book-open" href="https://dev.intention.xyz/">
    El recorrido completo para desarrolladores: instalación, autenticación y firma, inicio rápido con REST, cuentas, datos de mercado, órdenes, flujo de trading, transferencias de USDC y límites de solicitudes.
  </Card>

  <Card title="Referencia de la API" icon="plug" href="https://testnet-openapi.intention.xyz/">
    La especificación completa de REST y WebSocket, con esquemas y un ejecutor de solicitudes en el navegador.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  Qué cubre la API
</h2>

La referencia está organizada en estos grupos. Los recuentos son endpoints de la especificación actual de testnet.

| Grupo            | Qué cubre                                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Markets**      | Lista de mercados perpetuos, libros de órdenes, operaciones, velas, tasas de financiación                                                 |
| **Trading**      | Órdenes abiertas, ejecuciones, búsqueda por ID de orden del cliente                                                                       |
| **Transactions** | Enviar, enviar por lotes, simular, codificar y esperar transacciones; estimación de gas                                                   |
| **Accounts**     | Estado de direcciones y subdirecciones, posiciones, historial de órdenes, historial de operaciones, transferencias, pagos de financiación |
| **DEX Config**   | Definiciones de perpetuos y spot, configuración de comisiones, tramos de apalancamiento, vinculación de agentes                           |
| **Oracle**       | Precios certificados para el bloque actual                                                                                                |
| **Dashboard**    | Valor de la cuenta, series de PnL, calendario de trading, resúmenes                                                                       |
| **Export**       | Exportación a CSV del historial de órdenes, del historial de operaciones y de los pagos de financiación                                   |
| **WebSocket**    | Canales de suscripción para libro de órdenes, operaciones, ticker, velas, subcuentas, bloques y transacciones                             |

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

Herramientas interactivas para el desarrollo, todas alojadas en el sitio para desarrolladores.

<CardGroup cols={2}>
  <Card title="Faucet" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Consigue fondos de testnet para una cuenta nueva.
  </Card>

  <Card title="Búsqueda de órdenes" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Inspecciona el estado y el historial de cualquier orden por su ID.
  </Card>

  <Card title="Probador de WebSocket" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    Suscríbete a canales en vivo e inspecciona los mensajes en crudo.
  </Card>

  <Card title="Verificador BCS" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Comprueba que una transacción serializada codifica lo que esperas antes de firmarla.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK y código fuente
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    SDK oficiales en TypeScript, Go, Python y C++: generación de cuentas, firma, construcción de órdenes y transferencias.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    Código fuente de los SDK, del software de nodo y de las integraciones de referencia.
  </Card>
</CardGroup>

<Note>
  La especificación publicada apunta hoy a testnet. La forma de los endpoints es lo bastante estable como para construir sobre ella, pero considera sujeto a cambios todo lo que aún no se haya puesto a prueba en mainnet, hasta que las notas de versión de mainnet digan lo contrario.
</Note>

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

La operación de nodos **no está abierta**. El conjunto de validadores lo operan Intention Labs y socios invitados, y la entrada es por aprobación y no por registro: no hay un flujo público de incorporación ni un binario publicado para descarga general.

Si necesitas operar infraestructura, escribe a `contact@intention.xyz` con **Node operator** en el asunto. Consulta [Operar un nodo](/es/developers/run-a-node) para ver qué roles existen y qué incluir.

<Note>
  La mayoría de los motivos para querer un nodo son motivos de acceso de lectura: consultas fiables, historial, no depender del indexador de otro. Eso lo cubren la API de arriba y el [indexador](/es/protocol/architecture/indexer), sin operar nada.
</Note>

<h2 id="getting-help">
  Cómo conseguir ayuda
</h2>

Las preguntas de integración, el comportamiento inesperado de un endpoint y los acuerdos comerciales van todos a `contact@intention.xyz`. Consulta [Preguntas de desarrolladores e integración](/es/help/builder-questions) para saber qué incluir.