Desarrolladores

API de Ora

Ejecuta lanzamientos, operaciones y estrategias desde tus propios scripts, con los mismos endpoints que usa la app de Ora.

Autentícate con una clave de API, envía JSON y recibe JSON.

URL base: https://api.useora.xyz. Todas las rutas de esta sección son relativas a ella.

Inicio rápido

Pide que te activen el acceso a la API. Está desactivado por defecto en todas las cuentas. Pide al soporte de Ora que lo active en tu cuenta, en Discord o Telegram.
Crea una clave. En la app, haz clic en tu foto de perfil, arriba a la derecha, luego en API Key y después en Generate key. La clave se muestra una sola vez: cópiala en un gestor de secretos o en una variable de entorno. Al generar una clave aceptas las Condiciones de uso de la API, secciones 10.8 a 10.11 de los Términos del servicio de Ora.
Haz tu primera llamada. Un 200 significa que ya estás dentro. Un 401 significa que la clave es incorrecta; un 403, que el acceso a la API todavía no está activado.

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

Un cliente pequeño

Para cualquier cosa que vaya más allá de una llamada puntual, envuelve las llamadas en un cliente pequeño. Los ejemplos de esta sección dan por hecho que usas este (Node 18+, o cualquier entorno de ejecución con 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;
}

Por dónde seguir

Autenticación: cómo funciona la clave, y cómo rotarla o revocarla.
Solicitudes y errores: cantidades, direcciones, códigos de error y límites de frecuencia.
Firma y streams: los pocos flujos que firma tu propia wallet, y los datos en tiempo real.
Guías de la API: comprar y vender, estrategias, lanzar un token.
Endpoints: todas las rutas que puede llamar una clave.

Las preguntas y las solicitudes de acceso van al soporte de Ora. Indica el X-Request-ID de cualquier llamada sobre la que preguntes.