Endpoints

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.

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 montre comment lire un flux.