Développeurs

API Ora

Pilotez vos lancements, vos trades et vos stratégies depuis vos propres scripts, avec les mêmes endpoints que l'app Ora.

Authentifiez-vous avec une clé API, envoyez du JSON, recevez du JSON.

URL de base : https://api.useora.xyz. Tous les chemins de cette section sont relatifs à cette URL.

Démarrage rapide

Faites activer l'accès API. Il est désactivé par défaut sur tous les comptes. Demandez au support Ora de l'activer pour votre compte, sur Discord ou Telegram.
Créez une clé. Dans l'app, cliquez sur votre photo de profil en haut à droite, puis sur API Key, puis sur Generate key. La clé n'est affichée qu'une seule fois : copiez-la dans un coffre à secrets ou une variable d'environnement. En générant une clé, vous acceptez les Conditions d'utilisation de l'API, sections 10.8 à 10.11 des Conditions générales d'utilisation d'Ora.
Faites votre premier appel. Un 200 signifie que tout fonctionne. Un 401 signifie que la clé est incorrecte ; un 403, que l'accès API n'est pas encore activé.

curl https://api.useora.xyz/portfolio/stats \
  -H "Authorization: Bearer $ORA_API_KEY"

Un petit client

Au-delà d'un appel ponctuel, regroupez les appels dans un petit client. Les exemples de cette section supposent celui-ci (Node 18+, ou tout environnement d'exécution doté de fetch) :

const ORA = 'https://api.useora.xyz';
const KEY = process.env.ORA_API_KEY; // ora_…, never hard-coded

export async function ora(method, path, body) {
  const res = await fetch(ORA + path, {
    method,
    headers: {
      Authorization: `Bearer ${KEY}`,
      // Only when there is a body: a body-less POST with this header is refused (400).
      ...(body ? { 'Content-Type': 'application/json' } : {}),
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  const data = await res.json();
  if (!res.ok || data.success === false) {
    const err = new Error(`${res.status} ${data.error}${data.message ? `: ${data.message}` : ''}`);
    err.status = res.status;
    err.requestId = res.headers.get('x-request-id'); // quote it when you contact support
    throw err;
  }
  return data;
}

Pour aller plus loin

Authentification : le fonctionnement de la clé, et comment la renouveler ou la révoquer.
Requêtes & erreurs : montants, adresses, codes d'erreur et limites de débit.
Signature & flux : les quelques opérations que votre propre wallet signe, et les données en direct.
Guides de l'API : acheter et vendre, les stratégies, lancer un token.
Endpoints : toutes les routes qu'une clé peut appeler.

Les questions et les demandes d'accès sont à adresser au support Ora. Indiquez le X-Request-ID de chaque appel sur lequel porte votre question.