Widget y API de precio

Pon la mesa OTC de Nodo en tu web: un widget de una línea y una API de precio con tu margen incluido. Para partners de Nodo.

Si eres partner de Nodo, tus clientes pueden comprar USDC desde tu web. Tienes tres formas, todas con tu margen ya incluido en el precio:

	Para qué sirve	Qué necesitas
Enlace OTC	Compartirlo por correo, redes o mensaje	Tu código de partner
Widget	Una calculadora de compra en tu web	Una línea de código y tus dominios
API de precio	Mostrar el precio del USDC en tu propio sistema	Una clave de API

En los tres casos el cliente contrata con Nodo AI, Inc.: se verifica, firma el contrato y paga en nodoia.app. Tú no tocas datos de clientes ni dinero. Tu margen se suma al precio de Nodo, tus clientes ven solo el precio final y tú lo ganas en cada compra que hagan, sin límite de tiempo.

Cómo funciona

El cliente usa el widget en tu web, o tu sistema le muestra el precio: elige moneda (USD o EUR) y monto.
Toca Comprar con contrato. Se abre nodoia.app en una pestaña nueva, con el contrato ya rellenado con ese monto y esa moneda.
Se verifica una sola vez, firma y transfiere desde una cuenta bancaria a su nombre.
Cuando el depósito se acredita, la mesa entrega los USDC en la red Base.
Tú ves la compra en tu panel y cobras tu margen a fin de mes.

Pega esta línea donde quieras que aparezca la calculadora:

<script src="https://www.nodoia.app/widget.js" data-ref="TU-CODIGO"></script>

El script crea un iframe de nodoia.app justo después de la línea. El iframe ajusta su altura solo. Puedes poner varios en la misma página.

Opciones

Atributo	Valores	Para qué
`data-ref`	Tu código de partner	Obligatorio. Pone tu margen en el precio
`data-theme`	`light`, `dark`	Fondo claro u oscuro
`data-accent`	Un color, por ejemplo `#0f7b5f`	Color del botón
`data-lang`	`es`, `en`, `de`	Idioma
`data-currency`	`USD`, `EUR`	Moneda con la que abre
`data-amount`	Un número, por ejemplo `10000`	USDC con los que abre

Los colores, el idioma y la moneda también se eligen en tu panel de partner, sin tocar el código: lo que pongas en el código tiene prioridad. El precio nunca sale del código: siempre viene de Nodo, con el margen que guardaste en tu panel.

Dominios

El widget solo se muestra en los dominios que registras en tu panel, por ejemplo tuempresa.com y www.tuempresa.com. En cualquier otra web el navegador no lo muestra. Así nadie puede poner tu widget en una web falsa.

Lo que no cambia

El widget muestra siempre "Powered by nodo.ia · Nodo AI, Inc. · MSB registrado ante FinCEN".
El contrato se abre siempre en nodoia.app, con el diseño de Nodo.
Hoy el widget vende USDC. Dentro de su wallet Nodo, el cliente puede cambiarlo a USDT.

API de precio

Para mostrar el precio del USDC dentro de tu propio sistema, por ejemplo junto a las otras monedas de una casa de cambio. Es solo lectura: no crea órdenes ni mueve dinero.

Clave

En tu panel de partner, en API, toca Crear clave y cópiala: se muestra una sola vez. Guárdala en tu servidor, nunca en el navegador ni en una app. Puedes revocarla y crear otra cuando quieras.

Pedir el precio

curl "https://www.nodoia.app/api/v1/otc/price?currency=EUR&amount=10000" \
  -H "Authorization: Bearer nodo_pk_live_..."

Parámetro	Valores
`currency`	`USD`, `EUR`	Obligatorio
`amount`	USDC, de 5,000 a 1,000,000	Opcional. Con él, la respuesta trae el total

Respuesta

{
  "asset": "USDC",
  "network": "base",
  "currency": "EUR",
  "amount": 10000,
  "price": 0.9206,
  "total": 9206.0,
  "minUsdc": 5000,
  "maxUsdc": 1000000,
  "quoteMinutes": 15,
  "tiers": [
    { "minUsdc": 5000, "price": 0.9206 },
    { "minUsdc": 50000, "price": 0.9152 },
    { "minUsdc": 250000, "price": 0.9116 }
  ],
  "buyUrl": "https://www.nodoia.app/otc/buy?ref=TU-CODIGO&amount=10000&currency=EUR",
  "updatedAt": "2026-11-08T15:00:00.000Z"
}

price: el precio de un USDC para ese monto, con tu margen incluido. tiers trae el precio por tramo.
buyUrl: el enlace para tu botón de compra. Abre el contrato de Nodo con el monto y la moneda ya rellenados.

Errores y límites

Código	Error	Qué pasó
401	`invalid_key`	La clave no existe o está revocada
400	`invalid_currency`	La moneda no es USD ni EUR
400	`amount_out_of_range`	El monto está fuera de 5,000–1,000,000 USDC
429	`rate_limited`	Más de 60 consultas por minuto con esa clave

El precio

El precio del widget y de la API es orientativo. El que vale es el del contrato: queda fijo 15 minutos cuando el cliente lo abre para firmar, todo incluido. Desde 50,000 USDC el precio baja, y para montos grandes la mesa puede mejorarlo.

Preguntas: business@nodoia.app.