# Endpoints

> Toutes les routes de l'API Ora qu'une clé API peut appeler.

Toutes les routes que l'API expose à une clé. Toutes l'exigent. Les chemins sont relatifs à `https://api.useora.xyz` ; `{address}` et `{mint}` désignent le mint (Solana) ou le contrat (EVM) d'un token.

### Compte

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/auth/me` | Votre compte, en indiquant si l'accès API est activé (`apiAccess`) et si une clé existe (`hasApiKey`). |
| `POST` | `/me/api-key` | Crée une nouvelle clé API et la renvoie une seule fois. Toute clé précédente cesse aussitôt de fonctionner. |
| `POST` | `/me/api-key/revoke` | Révoque votre clé API : tout appel fait avec elle est refusé à partir de ce moment. |
| `POST` | `/me/referral-code` | Définit un code de parrainage personnalisé. |
| `GET` | `/me/rewards` | Tout ce qu'affichent la fenêtre Rewards et la carte de profil : points, rang, vos récompenses en route et à réclamer (`balance`), gains de parrainage et filleuls. |
| `POST` | `/rewards/claim` | Réclame vos récompenses : envoie la totalité de vos **Rewards to claim** (vos parts de cashback et de parrainage qui ont rejoint le pool de récompenses) sur votre wallet Ora en un seul transfert, en SOL. Les frais de réseau sont déduits du montant envoyé. Renvoie la `signature` du transfert et les `lamports` envoyés, ou `404` quand il n'y a rien à réclamer. |
| `GET` | `/me/settings` | Vos préférences de l'app, telles qu'enregistrées par `PUT /me/settings`. |
| `PUT` | `/me/settings` | Remplace intégralement vos préférences de l'app (sans fusion). |
| `GET` | `/user/pinned-tokens` | Vos tokens épinglés. |
| `POST` | `/user/pinned-tokens` | Épingle un token, ou le désépingle s'il est déjà épinglé. |
| `GET` | `/user/tracked-wallets` | Les wallets que vous suivez. |
| `POST` | `/user/tracked-wallets` | Ajoute des wallets à suivre, plusieurs à la fois. |
| `DELETE` | `/user/tracked-wallets/{address}` | Arrête de suivre un wallet. |
| `PATCH` | `/user/tracked-wallets/{address}` | Renomme un wallet suivi ou change son emoji. |
| `GET` | `/user/tracked-wallets/trades` | Les trades récents des wallets que vous suivez. |
| `GET` | `/user/tracked-wallets/trades/stream` | Les trades en direct des wallets que vous suivez (flux). |

### Lancement

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `POST` | `/engine/deploy/plan` | Propose une organisation des wallets et des layers pour un lancement, avec l'estimation complète de son coût et du marché, en un seul appel. |
| `POST` | `/engine/deploy/wallets/add` | Wallets personnalisés : ajoute des wallets holders et renvoie le plan recalculé (wallets, layers, devis et estimation). |
| `POST` | `/engine/deploy/wallets/allocation` | Wallets personnalisés : définit l'allocation d'un ou de plusieurs holders et renvoie le plan recalculé. |
| `POST` | `/engine/deploy/wallets/remove` | Wallets personnalisés : retire des holders et renvoie le plan recalculé. |
| `GET` | `/engine/launch-bounds` | Les Supply Buy % et Dev Buy % minimums qu'un lancement doit respecter. |
| `POST` | `/engine/drafts` | Crée un brouillon de lancement. |
| `GET` | `/engine/drafts/{id}` | Charge un brouillon de lancement. |
| `PUT` | `/engine/drafts/{id}` | Enregistre un brouillon de lancement. |
| `POST` | `/engine/drafts/{id}/archive` | Supprime un brouillon de lancement. |
| `GET` | `/engine/launches/drafts` | Tout ce qui n'est pas encore lancé : les brouillons de lancement, plus les infos de token envoyées mais jamais préparées. |
| `POST` | `/engine/prepare` | Prépare un lancement : crée le mint du token, le token brouillon et ses wallets. |
| `POST` | `/engine/{mint}/delete` | Supprime un token encore en préparation, ainsi que ses wallets. |
| `POST` | `/engine/fund` | Construit les transferts de SOL non signés qui financent les wallets d'un lancement, à faire signer par votre wallet. |
| `GET` | `/engine/fund/{mint}` | Les parties du Private Funding enregistrées pour un token. |
| `POST` | `/engine/fund/confirm` | Confirme que les transactions de financement sont bien arrivées on-chain. |
| `POST` | `/engine/fund/verify` | Vérifie un financement direct à partir des soldes des wallets. |
| `POST` | `/engine/launch` | Lance on-chain un token préparé. |
| `POST` | `/engine/cancel` | Construit les transactions qui récupèrent le SOL des wallets d'un lancement en préparation, financé ou en échec. Signées en partie par Ora ; votre wallet signe le reste. |
| `POST` | `/engine/cancel/submit` | Soumet les transactions d'annulation signées. |
| `POST` | `/engine/collect` | Construit les transactions qui collectent le produit d'un lancement. Signées en partie par Ora ; votre wallet signe le reste. |
| `POST` | `/engine/collect/submit` | Soumet les transactions de collecte signées, pour un `collectId`. |
| `GET` | `/engine/token/{address}/pre-deploy` | Estimation du coût de lancement d'un token préparé qui n'est pas encore lancé. |

### Trading

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/engine/tokens` | Vos tokens, par statut. |
| `GET` | `/engine/token/{address}` | L'identité d'un token : métadonnées, supply et statut de lancement. |
| `GET` | `/engine/token/{address}/positions` | Les positions de vos wallets sur un token : avoirs, solde en SOL, PnL réalisé et latent, ce que réservent les stratégies actives (`lockedTokens`, `lockedQuote`), et `totals`. |
| `PATCH` | `/engine/token/{address}/position/wallet-name` | Renomme l'un des wallets d'un token (le nom affiché dans le tableau des positions). |
| `POST` | `/engine/token/{address}/position/buy` | Achète sur plusieurs de vos wallets. |
| `POST` | `/engine/token/{address}/position/sell` | Vend sur plusieurs de vos wallets. |
| `POST` | `/engine/token/{address}/position/nuke` | Vend toutes les positions d'un coup (sortie d'urgence). |
| `POST` | `/engine/token/{address}/position/send/preview` | Établit le devis d'un envoi avant que vous ne le confirmiez. |
| `POST` | `/engine/token/{address}/position/send` | Envoie des tokens depuis un ou plusieurs de vos wallets Ora vers 5 adresses externes au maximum. Les frais d'Ora sont prélevés en tokens et vendus contre du SOL dans le même bundle. |
| `POST` | `/engine/token/{address}/burn` | Brûle des tokens depuis l'un de vos wallets. Cette action est irréversible. |
| `POST` | `/engine/token/{mint}/lock` | Verrouille des tokens de l'un de vos wallets Ora dans un lock temporel Streamflow. |
| `POST` | `/engine/token/{mint}/lock/withdraw` | Libère un lock vers le wallet qui l'a créé. |
| `GET` | `/engine/token/{mint}/locks` | Les locks d'un token. |
| `GET` | `/engine/burns/{mint}` | L'historique des burns d'un token. |
| `GET` | `/engine/sends/{mint}` | L'historique des envois d'un token. |
| `GET` | `/engine/token/{address}/creator-rewards` | Les récompenses créateur accumulées pour un token. |
| `POST` | `/engine/reward-claim` | Réclame les récompenses créateur accumulées dans un creator vault Pump.fun. |
| `POST` | `/engine/token/{mint}/layers` | Ajoute un layer de holders à un token que vous avez lancé (un nettoyage), rempli à parts égales avec vos propres wallets, aged ou importés, qu'aucun lancement n'utilise (`walletIds`). |
| `GET` | `/engine/unlock/{mint}` | Les wallets du token dont vous pouvez rassembler le SOL (solde supérieur à la réserve, les plus gros d'abord), le montant disponible dans chacun, le wallet de réception et la plage autorisée. |
| `POST` | `/engine/unlock` | Rassemble le montant de SOL que vous choisissez depuis les wallets d'un token vers son wallet de réception. Chaque wallet source paie ses propres frais. |
| `POST` | `/engine/token/{address}/callouts/watch` | Démarre ou renouvelle les Callouts du token : pendant un certain temps, ses callouts FOMO et Pump.fun sont récupérés régulièrement et vous sont envoyés en direct. |

### Stratégies

Les routes gardent leur nom en `-sells` mais gèrent aussi les stratégies d'achat : passez `side: "buy"` à la création. Voir [Stratégies d'achat](https://docs.useora.xyz/developers/guides/#buy-strategies).

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/engine/strategies` | Toutes les stratégies d'un token, de vente ou d'achat : Mirror, TWAP et Limit. |
| `GET` | `/engine/strategies/limit-sells` | Les ventes Limit d'un token. |
| `POST` | `/engine/strategies/limit-sells` | Crée une ou plusieurs ventes Limit pour un token, ou des achats Limit avec `side: "buy"`. |
| `PATCH` | `/engine/strategies/limit-sells/{id}` | Modifie une vente Limit (seulement les champs que vous envoyez). |
| `POST` | `/engine/strategies/limit-sells/{id}/enable` | Active une vente Limit. |
| `POST` | `/engine/strategies/limit-sells/{id}/disable` | Désactive une vente Limit. |
| `DELETE` | `/engine/strategies/limit-sells/{id}` | Supprime une vente Limit. |
| `GET` | `/engine/strategies/mirror-sells` | Les ventes Mirror d'un token. |
| `POST` | `/engine/strategies/mirror-sells` | Crée une ou plusieurs ventes Mirror pour un token, ou des achats Mirror avec `side: "buy"`. |
| `PATCH` | `/engine/strategies/mirror-sells/{id}` | Modifie une vente Mirror (seulement les champs que vous envoyez). |
| `POST` | `/engine/strategies/mirror-sells/{id}/enable` | Active une vente Mirror. |
| `POST` | `/engine/strategies/mirror-sells/{id}/disable` | Désactive une vente Mirror. |
| `DELETE` | `/engine/strategies/mirror-sells/{id}` | Supprime une vente Mirror. |
| `GET` | `/engine/strategies/twap-sells` | Les ventes TWAP d'un token. |
| `POST` | `/engine/strategies/twap-sells` | Crée une ou plusieurs ventes TWAP pour un token, ou des achats TWAP avec `side: "buy"`. |
| `PATCH` | `/engine/strategies/twap-sells/{id}` | Modifie une vente TWAP (seulement les champs que vous envoyez). |
| `POST` | `/engine/strategies/twap-sells/{id}/enable` | Active une vente TWAP. |
| `POST` | `/engine/strategies/twap-sells/{id}/disable` | Désactive une vente TWAP. |
| `DELETE` | `/engine/strategies/twap-sells/{id}` | Supprime une vente TWAP. |

### Portfolio

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/portfolio/stats` | Les stats du portfolio. |
| `GET` | `/portfolio/performance` | La performance du portfolio sur une période (par défaut : depuis le début). |
| `GET` | `/portfolio/coins` | Vos positions ouvertes sur des coins. |
| `GET` | `/portfolio/history` | Vos positions clôturées. |
| `GET` | `/portfolio/pnl-calendar` | Le calendrier du PnL quotidien. |
| `GET` | `/portfolio/pnl-chart` | Le PnL réalisé cumulé dans le temps, pour les graphiques. |
| `GET` | `/portfolio/launches` | Vos lancements, avec leurs soldes et les avoirs restés dans leurs wallets. |
| `GET` | `/portfolio/launches-chart` | Le nombre de lancements par période, pour les graphiques. |
| `POST` | `/portfolio/launches/{id}/archive` | Archive un lancement, ou le désarchive s'il est archivé. |
| `GET` | `/engine/launches/completed` | Tous les tokens que vous avez créés et qui ont un mint, quel que soit leur statut (la page Launches). |
| `GET` | `/portfolio/wallets` | Les wallets d'un ou de plusieurs lancements, avec ce que chacun détient encore. |
| `GET` | `/portfolio/wallets/available` | Vos wallets qu'aucun lancement n'utilise (achetés ou importés), avec leur `source` et l'`id` que `POST /engine/prepare` accepte comme `warmWalletId`. |
| `POST` | `/portfolio/wallets/import` | Importe des wallets à partir de vos propres clés privées (`source: imported`). |
| `POST` | `/portfolio/wallets/exit-preview` | Donne un aperçu, token par token, de ce que `POST /portfolio/wallets/exit` avec une `destination` enverrait via Husher pour ces wallets, avant tout mouvement. |
| `POST` | `/portfolio/wallets/exit` | Retire les wallets de `walletAddresses` vers l'adresse `destination` via Husher : chaque wallet paie sa propre adresse de dépôt Husher, et Husher paie `destination` une fois par token (jusqu'à 70 wallets par token, les plus gros d'abord). Envoyez toujours `destination`. Le **Consolidate Withdraw** de l'app les envoie sur votre wallet Ora. |
| `GET` | `/portfolio/wallets/exits` | Vos 20 retraits les plus récents depuis des wallets de lancement, un par token, du plus récent au plus ancien, avec leur progression. |

### Marketplace

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/portfolio/marketplace/wallets` | Les aged wallets en vente : mis en vente un jour après leur financement, avec un achat abouti, sans propriétaire et non réservés par un autre acheteur. |
| `POST` | `/portfolio/marketplace/quote` | Fixe le prix d'aged wallets sur une chain et vous les réserve pendant environ 2 minutes. |
| `POST` | `/portfolio/marketplace/buy` | Paie un devis : envoyez ses dépôts signés, dans son ordre et sans modification (sinon `409`). Ora les diffuse. |

### Données de marché et devis

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/engine/token/{address}/metrics` | Les métriques du token : market cap, prix, liquidité et supply. |
| `GET` | `/engine/token/{address}/candles` | Une page de bougies OHLCV, de la plus ancienne à la plus récente : jusqu'à `limit` bougies (300 par défaut et au maximum) avant `before`, ou les plus récentes sans `before`. |
| `GET` | `/engine/token/{address}/live-stats` | Les stats de trading en direct pour toutes les périodes (5m, 1h, 6h, 24h) en une seule réponse : achats, ventes, volume, traders uniques, répartition de la détention et variation de prix. |
| `GET` | `/engine/token/{address}/trades` | Les trades récents d'un token, du plus récent au plus ancien, avec des filtres facultatifs par wallet, montant et date. |
| `GET` | `/engine/token/{address}/holders` | Les holders d'un token, avec le solde de chacun et sa part de la supply, et lesquels de ces wallets sont les vôtres. |
| `GET` | `/engine/token/{address}/top-traders` | Les top traders d'un token, classés par PnL. |
| `GET` | `/tokens/{mint}/trades` | Le fil public des trades d'un token. |
| `GET` | `/tokens/{mint}/holders` | Les top holders d'un token, les plus gros d'abord, page par page. |
| `GET` | `/quote/sol-for-percent` | Le SOL nécessaire pour acheter un % donné de la supply. |
| `GET` | `/quote/tokens-for-sol` | Les tokens reçus pour un montant donné en unités de base (lamports sur Solana, wei sur EVM). |
| `GET` | `/launchpads/{protocol}/quotes` | Les actifs appairés qu'un launchpad accepte sur sa chain, le natif en premier. |
| `GET` | `/launchpads/pumpfun/charities` | Recherche par nom parmi les associations caritatives actives de donate.gg, pour `pumpfunFeeShares` dans `POST /engine/prepare` (`kind: 'charity'`, `charityId` = `id`). |
| `GET` | `/market/lighthouse` | Le pouls du marché, tel qu'il s'affiche dans le pied de page de l'app. |
| `GET` | `/pnl/calendar` | Les données du calendrier du PnL quotidien. |
| `GET` | `/pnl/summary` | Le résumé du PnL, tel qu'il s'affiche sur une carte PNL. |

### Infos de token

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/tokens` | Les infos de token, les plus récentes d'abord. |
| `GET` | `/tokens/{id}/image` | L'image traitée d'un token, par ID d'infos de token. |
| `GET` | `/tokens/{id}/banner` | La bannière traitée d'un token, par ID d'infos de token. |
| `GET` | `/tokens/{mint}/logo` | Le logo d'un token, par mint (vos tokens uniquement). |
| `GET` | `/tokens/{mint}/cover` | La bannière d'un token, par mint (vos tokens uniquement). |
| `POST` | `/upload` | Envoie des infos de token. |
| `POST` | `/upload/{protocol}` | Envoie des infos de token pour un launchpad. |
| `POST` | `/upload/bags` | Envoie des infos de token pour Bags. |

### Flux

| Méthode | Chemin | Ce qu'elle fait |
|---|---|---|
| `GET` | `/engine/tokens/{mint}/stream` | Tout ce qui concerne un token sur une seule connexion : événements d'état, trades, les wallets connus qui le détiennent, et les stats des holders. |
| `GET` | `/user/tracked-wallets/trades/stream` | Les trades en direct des wallets que vous suivez. |
| `GET` | `/sol-usd/events` | Prix SOL/USD. |
| `GET` | `/blockhash/events` | Dernier blockhash et hauteur de bloc, environ toutes les 220 ms. |
| `GET` | `/jito/tip-lamports/events` | Percentiles du tip floor Jito. |
| `GET` | `/jito/tip-accounts/events` | Liste des comptes de tip Jito. |

[Signature & flux](https://docs.useora.xyz/developers/signing-and-streams/#real-time-streams) montre comment lire un flux.