# Endpoints

> Todas las rutas de la API de Ora que puede llamar una clave de API.

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](https://docs.useora.xyz/developers/guides/#buy-strategies).

| 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](https://docs.useora.xyz/developers/signing-and-streams/#real-time-streams) muestra cómo leer un stream.