Endpoints

Todas las rutas que la API expone a una clave. Todas la requieren. Las rutas son relativas a https://api.useora.xyz; {address} y {mint} son el mint (Solana) o el contrato (EVM) de un token.

Cuenta

Método	Ruta	Qué hace
GET	/auth/me	Tu cuenta, incluido si el acceso a la API está activado (apiAccess) y si existe una clave (hasApiKey).
POST	/me/api-key	Crea una nueva clave de API y la devuelve una sola vez. Cualquier clave anterior deja de funcionar de inmediato.
POST	/me/api-key/revoke	Revoca tu clave de API: todas las llamadas hechas con ella se rechazan a partir de ese momento.
POST	/me/referral-code	Define un código de referido personalizado.
GET	/me/rewards	Todo lo que hay en la ventana Rewards y en la tarjeta de perfil: puntos, rango, tus recompensas en camino y por reclamar (balance), ganancias por referidos y referidos.
POST	/rewards/claim	Reclama tus recompensas: envía todas tus Rewards to claim (tu cashback y tus partes de referidos que ya han llegado al pool de recompensas) a tu wallet de Ora en una sola transferencia, en SOL. La comisión de red se descuenta de la cantidad enviada. Devuelve la signature de la transferencia y los lamports enviados, o 404 cuando no hay nada que reclamar.
GET	/me/settings	Tus preferencias de la app, tal como las guardó PUT /me/settings.
PUT	/me/settings	Reemplaza por completo tus preferencias de la app (sin fusionar).
GET	/user/pinned-tokens	Tus tokens fijados.
POST	/user/pinned-tokens	Fija un token, o lo desfija si ya está fijado.
GET	/user/tracked-wallets	Las wallets que sigues.
POST	/user/tracked-wallets	Añade wallets para seguir, varias a la vez.
DELETE	/user/tracked-wallets/{address}	Deja de seguir una wallet.
PATCH	/user/tracked-wallets/{address}	Cambia el nombre de una wallet seguida o su emoji.
GET	/user/tracked-wallets/trades	Operaciones recientes de las wallets que sigues.
GET	/user/tracked-wallets/trades/stream	Operaciones en tiempo real de las wallets que sigues (stream).

Lanzamiento

Método	Ruta	Qué hace
POST	/engine/deploy/plan	Sugiere una distribución de wallets y capas para un lanzamiento, con su estimación completa de costo y de mercado, en una sola llamada.
POST	/engine/deploy/wallets/add	Wallets personalizadas: añade wallets holders y devuelve el plan recalculado (wallets, capas, cotizaciones y estimación).
POST	/engine/deploy/wallets/allocation	Wallets personalizadas: define la asignación de uno o varios holders y devuelve el plan recalculado.
POST	/engine/deploy/wallets/remove	Wallets personalizadas: elimina holders y devuelve el plan recalculado.
GET	/engine/launch-bounds	El Supply Buy % y el Dev Buy % mínimos que debe cumplir un lanzamiento.
POST	/engine/drafts	Crea un borrador de lanzamiento.
GET	/engine/drafts/{id}	Carga un borrador de lanzamiento.
PUT	/engine/drafts/{id}	Guarda un borrador de lanzamiento.
POST	/engine/drafts/{id}/archive	Elimina un borrador de lanzamiento.
GET	/engine/launches/drafts	Todo lo que aún no se ha lanzado: los borradores de lanzamiento, más la información de token que se subió pero nunca se preparó.
POST	/engine/prepare	Prepara un lanzamiento: crea el mint del token, el token en borrador y sus wallets.
POST	/engine/{mint}/delete	Elimina un token que aún se está preparando, y sus wallets.
POST	/engine/fund	Construye las transferencias de SOL sin firmar que financian las wallets de un lanzamiento, para que tu wallet las firme.
GET	/engine/fund/{mint}	Las partes de Private Funding registradas para un token.
POST	/engine/fund/confirm	Confirma que las transacciones de financiación han llegado on-chain.
POST	/engine/fund/verify	Comprueba la financiación directa a partir de los saldos de las wallets.
POST	/engine/launch	Lanza on-chain un token preparado.
POST	/engine/cancel	Construye las transacciones que recuperan el SOL de las wallets de un lanzamiento que se está preparando, está financiado o ha fallado. Parcialmente firmadas por Ora; tu wallet firma el resto.
POST	/engine/cancel/submit	Envía las transacciones de cancelación firmadas.
POST	/engine/collect	Construye las transacciones que recogen lo recaudado por un lanzamiento. Parcialmente firmadas por Ora; tu wallet firma el resto.
POST	/engine/collect/submit	Envía las transacciones de recogida firmadas, para un collectId.
GET	/engine/token/{address}/pre-deploy	Estimación del costo de lanzamiento de un token preparado que aún no se ha lanzado.

Trading

Método	Ruta	Qué hace
GET	/engine/tokens	Tus tokens, por estado.
GET	/engine/token/{address}	La identidad de un token: metadatos, supply y estado del lanzamiento.
GET	/engine/token/{address}/positions	Las posiciones de tus wallets en un token: holdings, saldo de SOL, PnL realizado y no realizado, lo que reservan las estrategias activas (lockedTokens, lockedQuote) y totals.
PATCH	/engine/token/{address}/position/wallet-name	Cambia el nombre de una de las wallets de un token (el nombre que aparece en la tabla de posiciones).
POST	/engine/token/{address}/position/buy	Compra desde varias de tus wallets.
POST	/engine/token/{address}/position/sell	Vende desde varias de tus wallets.
POST	/engine/token/{address}/position/nuke	Vende todas las posiciones de una vez (salida de emergencia).
POST	/engine/token/{address}/position/send/preview	Cotiza un envío antes de que lo confirmes.
POST	/engine/token/{address}/position/send	Envía tokens desde una o varias de tus wallets de Ora a un máximo de 5 direcciones externas. La comisión de Ora se cobra en tokens y se vende por SOL en el mismo bundle.
POST	/engine/token/{address}/burn	Quema tokens de una de tus wallets. No se puede deshacer.
POST	/engine/token/{mint}/lock	Bloquea tokens de una de tus wallets de Ora en un bloqueo temporal de Streamflow.
POST	/engine/token/{mint}/lock/withdraw	Libera un bloqueo de vuelta a la wallet que lo creó.
GET	/engine/token/{mint}/locks	Los bloqueos de un token.
GET	/engine/burns/{mint}	El historial de quemas de un token.
GET	/engine/sends/{mint}	El historial de envíos de un token.
GET	/engine/token/{address}/creator-rewards	Las recompensas de creador acumuladas de un token.
POST	/engine/reward-claim	Reclama las recompensas de creador acumuladas en un creator vault de Pump.fun.
POST	/engine/token/{mint}/layers	Añade una capa de holders a un token que lanzaste (una limpieza), que se llena a partes iguales con tus propias aged wallets o wallets importadas que ningún lanzamiento usa (walletIds).
GET	/engine/unlock/{mint}	Las wallets del token de las que puedes reunir SOL (saldo por encima de la reserva, de mayor a menor), la cantidad disponible en cada una, la wallet receptora y el rango permitido.
POST	/engine/unlock	Reúne la cantidad de SOL que elijas de las wallets de un token en su wallet receptora. Cada wallet de origen paga su propia comisión.
POST	/engine/token/{address}/callouts/watch	Inicia o renueva los Callouts del token: durante un tiempo, sus callouts de FOMO y Pump.fun se consultan con regularidad y se te envían en tiempo real.

Estrategias

Las rutas conservan sus nombres en -sells, pero también gestionan las estrategias de compra: pasa side: "buy" al crear una. Consulta Estrategias de compra.

Método	Ruta	Qué hace
GET	/engine/strategies	Todas las estrategias de un token, de venta o de compra: mirror, TWAP y limit.
GET	/engine/strategies/limit-sells	Las ventas limit de un token.
POST	/engine/strategies/limit-sells	Crea una o varias ventas limit para un token, o compras limit con side: "buy".
PATCH	/engine/strategies/limit-sells/{id}	Edita una venta limit (solo los campos que envías).
POST	/engine/strategies/limit-sells/{id}/enable	Activa una venta limit.
POST	/engine/strategies/limit-sells/{id}/disable	Desactiva una venta limit.
DELETE	/engine/strategies/limit-sells/{id}	Elimina una venta limit.
GET	/engine/strategies/mirror-sells	Las ventas mirror de un token.
POST	/engine/strategies/mirror-sells	Crea una o varias ventas mirror para un token, o compras mirror con side: "buy".
PATCH	/engine/strategies/mirror-sells/{id}	Edita una venta mirror (solo los campos que envías).
POST	/engine/strategies/mirror-sells/{id}/enable	Activa una venta mirror.
POST	/engine/strategies/mirror-sells/{id}/disable	Desactiva una venta mirror.
DELETE	/engine/strategies/mirror-sells/{id}	Elimina una venta mirror.
GET	/engine/strategies/twap-sells	Las ventas TWAP de un token.
POST	/engine/strategies/twap-sells	Crea una o varias ventas TWAP para un token, o compras TWAP con side: "buy".
PATCH	/engine/strategies/twap-sells/{id}	Edita una venta TWAP (solo los campos que envías).
POST	/engine/strategies/twap-sells/{id}/enable	Activa una venta TWAP.
POST	/engine/strategies/twap-sells/{id}/disable	Desactiva una venta TWAP.
DELETE	/engine/strategies/twap-sells/{id}	Elimina una venta TWAP.

Portfolio

Método	Ruta	Qué hace
GET	/portfolio/stats	Estadísticas del portfolio.
GET	/portfolio/performance	Rendimiento del portfolio en un periodo (por defecto: todo el historial).
GET	/portfolio/coins	Tus posiciones abiertas en monedas.
GET	/portfolio/history	Tus posiciones cerradas.
GET	/portfolio/pnl-calendar	Calendario de PnL diario.
GET	/portfolio/pnl-chart	PnL realizado acumulado a lo largo del tiempo, para gráficos.
GET	/portfolio/launches	Tus lanzamientos, con sus saldos y los holdings que quedan en sus wallets.
GET	/portfolio/launches-chart	Número de lanzamientos por periodo, para gráficos.
POST	/portfolio/launches/{id}/archive	Archiva un lanzamiento, o lo desarchiva si está archivado.
GET	/engine/launches/completed	Todos los tokens que creaste y que tienen un mint, sea cual sea su estado (la página Launches).
GET	/portfolio/wallets	Las wallets de uno o varios lanzamientos, con lo que cada una aún tiene.
GET	/portfolio/wallets/available	Tus wallets que ningún lanzamiento usa (compradas o importadas), con su source y el id que POST /engine/prepare recibe como warmWalletId.
POST	/portfolio/wallets/import	Importa wallets a partir de tus propias claves privadas (source: imported).
POST	/portfolio/wallets/exit-preview	Muestra una vista previa, token por token, de lo que POST /portfolio/wallets/exit con un destination enviaría a través de Husher para estas wallets, antes de que se mueva nada.
POST	/portfolio/wallets/exit	Retira las wallets de walletAddresses a la dirección destination a través de Husher: cada wallet paga a su propia dirección de depósito de Husher, y Husher paga a destination una vez por token (hasta 70 wallets por token, de mayor a menor). Envía siempre destination. El Consolidate Withdraw de la app las envía a tu wallet de Ora.
GET	/portfolio/wallets/exits	Tus 20 retiros más recientes desde wallets de lanzamiento, uno por token, del más reciente al más antiguo, con su progreso.

Marketplace

Método	Ruta	Qué hace
GET	/portfolio/marketplace/wallets	Aged wallets en venta: a la venta un día después de su financiación y con una compra ejecutada, sin propietario y no reservadas por otro comprador.
POST	/portfolio/marketplace/quote	Cotiza aged wallets en una chain y te las reserva durante unos 2 minutos.
POST	/portfolio/marketplace/buy	Paga una cotización: envía sus depósitos firmados, en su orden y sin modificar (de lo contrario, 409). Ora los transmite.

Datos de mercado y cotizaciones

Método	Ruta	Qué hace
GET	/engine/token/{address}/metrics	Métricas del token: market cap, precio, liquidez y supply.
GET	/engine/token/{address}/candles	Una página de velas OHLCV, de la más antigua a la más reciente: hasta limit velas (300 por defecto y como máximo) anteriores a before, o las más recientes sin before.
GET	/engine/token/{address}/live-stats	Estadísticas de trading en tiempo real para cada periodo (5m, 1h, 6h, 24h) en una sola respuesta: compras, ventas, volumen, traders únicos, reparto de la propiedad y variación del precio.
GET	/engine/token/{address}/trades	Las operaciones recientes de un token, de la más reciente a la más antigua, con filtros opcionales por wallet, cantidad y tiempo.
GET	/engine/token/{address}/holders	Los holders de un token, con el saldo y la parte del supply de cada uno, y cuáles de las wallets son tuyas.
GET	/engine/token/{address}/top-traders	Los top traders de un token, ordenados por PnL.
GET	/tokens/{mint}/trades	Feed público de operaciones de un token.
GET	/tokens/{mint}/holders	Los principales holders de un token, de mayor a menor, página por página.
GET	/quote/sol-for-percent	SOL necesario para comprar un % determinado del supply.
GET	/quote/tokens-for-sol	Tokens recibidos por una cantidad determinada en unidades base (lamports en Solana, wei en EVM).
GET	/launchpads/{protocol}/quotes	Los activos emparejados que acepta un launchpad en su chain, el nativo primero.
GET	/launchpads/pumpfun/charities	Busca por nombre las organizaciones benéficas activas de donate.gg, para pumpfunFeeShares en POST /engine/prepare (kind: 'charity', charityId = id).
GET	/market/lighthouse	Pulso del mercado, tal como aparece en el pie de página de la app.
GET	/pnl/calendar	Datos del calendario de PnL diario.
GET	/pnl/summary	Resumen de PnL, tal como aparece en una tarjeta PNL.

Información del token

Método	Ruta	Qué hace
GET	/tokens	Información de tokens, de la más reciente a la más antigua.
GET	/tokens/{id}/image	La imagen procesada de un token, por ID de información del token.
GET	/tokens/{id}/banner	El banner procesado de un token, por ID de información del token.
GET	/tokens/{mint}/logo	El logo de un token, por mint (solo tus tokens).
GET	/tokens/{mint}/cover	El banner de un token, por mint (solo tus tokens).
POST	/upload	Sube información de token.
POST	/upload/{protocol}	Sube información de token para un launchpad.
POST	/upload/bags	Sube información de token para Bags.

Streams

Método	Ruta	Qué hace
GET	/engine/tokens/{mint}/stream	Todo sobre un token en una sola conexión: eventos de estado, operaciones, las wallets conocidas que lo tienen y las estadísticas de holders.
GET	/user/tracked-wallets/trades/stream	Operaciones en tiempo real de las wallets que sigues.
GET	/sol-usd/events	Precio SOL/USD.
GET	/blockhash/events	Último blockhash y altura de bloque, aproximadamente cada 220 ms.
GET	/jito/tip-lamports/events	Percentiles del tip floor de Jito.
GET	/jito/tip-accounts/events	Lista de cuentas de tip de Jito.

Firma y streams muestra cómo leer un stream.