Saltar al contenido principal
Los tokens RWA representan un derecho proporcional sobre un proyecto de regalías publicado. La API usa cadenas decimales exactas: nunca envíes números de punto flotante. Antes de comprar, el proyecto publica precio, oferta, términos de regalías, ventana de suscripción y si permite rescates.

Recorrido del inversionista

1. Buscar un proyecto

Usa GET /platform/v1/rwa/projects/{code} para consultar los términos completos. Los estados posibles son draft, funding, active, distributing, defaulted, redeemed y paused.

2. Comprar tokens

El monto solicitado es el monto bruto en USDT. La comisión configurada rwa_subscription se cobra aparte y la cantidad de tokens se calcula sobre el monto neto.
Comprar exige identidad verificada, OTP si la sesión humana lo requiere, USDT disponible y una clave de idempotencia. Reutilizar la misma clave devuelve la operación original.

3. Vender un título en el mercado secundario interno

El mercado secundario es un RFQ entre dos cuentas verificadas de la misma organización. Crear una oferta bloquea la cantidad exacta de títulos. El bloqueo se libera al cancelar o vencer, y solo un comprador puede aceptarla.
La oferta emite rwa_secondary_offer_open. El comprador acepta con POST /platform/v1/rwa/secondary/offers/{offerID}/accept y una clave de idempotencia. La liquidación es atómica: el título pasa al comprador, el USDT acordado al vendedor y la comisión rwa_secondary (porcentaje más fijo) se cobra al comprador. Las entradas de cartola son secondary_hold, secondary_release, secondary_fill, secondary_proceeds y secondary_charge. Cancelar o vencer emite rwa_secondary_offer_closed; liquidar emite rwa_secondary_filled. No reintentes con una clave nueva después de un timeout. Crear con un TTL fuera de 15–1440 minutos devuelve 400 invalid_ttl; aceptar una oferta ya vencida devuelve 410 offer_expired. Self-trade devuelve 400 y un segundo comprador devuelve 409.

4. Reportes, default y rescate final

Los holders solo pueden listar y consultar reportes aprobados. El período usa YYYY-MM y la aprobación congela NAV y yield. El servidor verifica gross_sales = units_sold × realized_price y royalty_due = floor(net_payable × royalty_pct / 100) con aritmética exacta. El maker propone y otro administrador identificado aprueba o rechaza. El default automático usa cure_days en el barrido diario. Si es NULL, el modo seguro exige acción manual. La prealerta es única y usa rwa_default_declared con stage=prealert; la declaración usa stage=declared. Un administrador de plataforma puede curar mediante PATCH, incluso después del plazo si la transición sigue siendo válida. La evidencia se retiene 90 días. El rescate final usa una distribución maker-checker con is_final=true. Exige que la attestation declare el remanente exacto al cap, incluso cero; escrow debe cubrirlo (>=), con cola limpia y ninguna oferta abierta. El proyecto se pausa, las ofertas se cancelan y las propuestas finales anteriores se superseden; la aprobación paga el remanente, quema los títulos y marca redeemed. Las quemas posteriores al cierre quedan estacionadas para revisión.

5. Revisar saldos y distribuciones

Las distribuciones usan el saldo del snapshot de ex-date:
Los listados de suscripciones, rescates y distribuciones aceptan from, to y page; cada recurso tiene consulta individual y comprobante PDF.

6. Rescatar

El rescate devuelve USDT al precio de suscripción del proyecto y descuenta los tokens de forma atómica.

Estados, errores y webhooks

funding permite suscripciones si la ventana y los topes lo permiten; active opera y puede distribuir; distributing procesa una distribución; paused requiere esperar; defaulted y redeemed no aceptan nuevas suscripciones. Consulta Errores para rwa_window_closed, rwa_cap_exceeded, rwa_fee_exceeds_amount, rwa_redeem_disabled y rwa_escrow_insufficient. Ante timeout o 5xx, consulta el recurso con la misma clave antes de actuar. Verifica la firma de rwa_subscription_completed, rwa_distribution_credited, rwa_redeem_completed, rwa_secondary_offer_open, rwa_secondary_offer_closed y rwa_secondary_filled. Revisa Webhooks.

Preguntas frecuentes

No. F1 rescata al precio de suscripción del proyecto.
Ante un timeout o 5xx, primero consulta la operación original con la misma clave de idempotencia.
La participación se calcula con el saldo del snapshot de ex-date.
No. El bridge es F2 y no forma parte de RWA F1.
Última modificación el 17 de noviembre de 2026