> For the complete documentation index, see [llms.txt](https://docs.ston.fi/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ston.fi/es/seccion-para-desarrolladores/omniston/sdk.md).

# SDK

Kits de desarrollo de software para integrar la agregación de liquidez de Omniston en flujos de intercambio y liquidación de órdenes.

## Características

* **Mejor descubrimiento de precio**: Encuentra automáticamente las rutas óptimas de intercambio y órdenes
* **Agregación entre cadenas**: Compatible con flujos de liquidación entre cadenas
* **Cotizaciones en tiempo real**: Actualizaciones de RFQ en vivo por WebSocket
* **APIs específicas de liquidación**: Generadores de transacciones TON y flujos de carga útil de órdenes EVM
* **Manejo de errores**: Tipos de error exhaustivos y recuperación

## SDKs

Proporcionamos dos paquetes para diferentes casos de uso:

* `@ston-fi/omniston-sdk` para uso directo del SDK en servicios backend, bots, scripts y arquitecturas de aplicaciones personalizadas
* `@ston-fi/omniston-sdk-react` para aplicaciones React que quieren que Omniston esté expuesto como hooks listos para usar

### SDK de Node.js

Usa el SDK de Node.js cuando quieras acceso directo a la superficie de la API de Omniston y control total sobre el manejo de solicitudes, cotizaciones y liquidaciones.

#### Beneficios clave:

* Acceso de bajo nivel a las APIs de RFQ, seguimiento y liquidación
* Integración directa basada en Observable sin dependencias de React
* La mejor opción para servicios backend, bots, acciones de servidor y arquitecturas de aplicaciones personalizadas
* Más fácil crear tus propias abstracciones sobre los primitivos del SDK en bruto

#### Instalación:

```bash
npm install @ston-fi/omniston-sdk
```

#### Inicio rápido:

```typescript
import { Omniston } from '@ston-fi/omniston-sdk';

const omniston = new Omniston({
  apiUrl: 'wss://omni-ws.ston.fi'
});

omniston.requestForQuote({ /** */ }).subscribe((quoteEvent) => {
  switch (quoteEvent?.$case) {
    case 'ack':
      console.log('ID de RFQ:', quoteEvent.value.rfqId);
      break;
    case 'quoteUpdated':
      console.log('Cotización:', quoteEvent.value);
      break;
    case 'noQuote':
      console.log('No hay cotización disponible');
      break;
  }
});
```

#### Guía detallada:

* [Documentación del SDK de Node.js](/es/seccion-para-desarrolladores/omniston/sdk/nodejs.md)

### SDK de React

Usa el SDK de React cuando estés creando una aplicación React y quieras que Omniston esté expuesto como hooks listos para usar.

#### Beneficios clave:

* API centrada en React construida sobre el SDK base
* Integración con TanStack Query para carga, caché y actualizaciones impulsadas por flujos
* Menos código repetitivo para vincular los flujos de RFQ, seguimiento y liquidación al estado de la interfaz
* La mejor opción para aplicaciones web, interfaces conectadas a billeteras y paneles

#### Instalación:

```bash
npm install @ston-fi/omniston-sdk-react
```

#### Inicio rápido:

```tsx
import { useRfq } from '@ston-fi/omniston-sdk-react';

function SwapComponent() {
  const { data: quoteEvent, error } = useRfq({ /** */ });

  if (error) {
    return <ErrorState error={error} />;
  }

  switch (quoteEvent?.$case) {
    case 'quoteUpdated':
      return <QuotePreview quote={quoteEvent.value} />;
    case 'noQuote':
      return <NoQuote />;
    case 'ack':
    default:
      return <Loading />;
  }
}
```

#### Guía detallada:

* [Documentación del SDK de React](/es/seccion-para-desarrolladores/omniston/sdk/react.md)
* [Migración del SDK de React de v0.7 a v0.8](/es/seccion-para-desarrolladores/omniston/sdk/migration-v0.7-to-v0.8.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ston.fi/es/seccion-para-desarrolladores/omniston/sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.