Recorrido del inversionista
1. Buscar un proyecto
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 configuradarwa_subscription se cobra aparte y la cantidad de tokens se calcula sobre el monto neto.
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.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 usaYYYY-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
from, to y page; cada recurso tiene consulta individual y comprobante PDF.
6. Rescatar
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
¿El precio del token fluctúa?
¿El precio del token fluctúa?
No. F1 rescata al precio de suscripción del proyecto.
¿Puedo reenviar una solicitud fallida?
¿Puedo reenviar una solicitud fallida?
Ante un timeout o 5xx, primero consulta la operación original con la misma clave de idempotencia.
¿Por qué mi distribución no usa mi saldo actual?
¿Por qué mi distribución no usa mi saldo actual?
La participación se calcula con el saldo del snapshot de ex-date.
¿Está disponible el bridge?
¿Está disponible el bridge?
No. El bridge es F2 y no forma parte de RWA F1.