Genesis Arbitrage

Genesis Arbitrage · · 3 min de lectura

API

Una API (interfaz de programación de aplicaciones) es un conjunto de reglas con las que un programa pide datos o una acción a otro: a qué URL llamar, qué enviar y en qué formato llega la respuesta. Un trader necesita una API cuando un programa debe leer precios, libros de órdenes y tasas de financiación (funding): un bot, una hoja de cálculo o un panel.

Ejemplo de petición

Ejemplo hipotético: un programa pide a Genesis API el perfil de la moneda IRYS mediante Búsqueda de monedas, un endpoint de la API. La petición es un HTTP GET con la clave en una cabecera:

curl "https://api.genesisarbitrage.com/v1/coins/search?query=IRYS" \
  -H "X-API-Key: $GENESIS_API_KEY"

La respuesta llega en JSON, con algunos campos omitidos:

{
  "coin": "IRYS",
  "contracts": [
    {
      "address": "0x91152b4ef635403efbae860edd0f8c321d7c035d",
      "network": "BNB Smart Chain(BEP20)",
      "exchanges": ["MEXC", "Ourbit"]
    }
  ],
  "exchanges": {
    "MEXC": {
      "spot_price": 0.01329,
      "futures_price": 0.0133,
      "deposit": true,
      "withdraw": true
    }
  }
}

Una persona tendría que juntar estos datos de las páginas de los exchanges y de un explorador de bloques; un programa los recibe en una sola respuesta y puede calcular al instante que los futuros de MEXC cotizan por encima del spot en (0,0133 − 0,01329) / 0,01329 × 100 ≈ 0,075 %.

API públicas y privadas de exchanges

Una API de exchange tiene dos partes. La parte pública sirve datos de mercado (cotizaciones, libros de órdenes, operaciones) sin clave. La parte privada trabaja con tu cuenta (saldos, órdenes, historial) y exige una clave de API y una firma de la petición. En Binance, los endpoints públicos tienen el tipo de seguridad NONE; todos los demás requieren una clave y el parámetro signature.

Los datos llegan de dos maneras. Una REST API responde cada petición por separado: así se obtiene una instantánea de los datos con los filtros necesarios. Un WebSocket mantiene la conexión abierta y el servidor envía las actualizaciones por su cuenta: así Binance transmite operaciones y cambios del libro de órdenes en tiempo real.

API de datos: muchas plataformas en una respuesta

Una API de exchange solo conoce su propia plataforma. Para comparar el precio de una moneda en 20 exchanges, un programa necesita 20 conexiones, y cada exchange tiene su formato de respuesta y sus límites. Una API de datos reúne las plataformas de antemano.

Tipo de APIQué devuelveAcceso
API pública de exchangeCotizaciones, libros de órdenes y operaciones de un exchangeSin clave
API privada de exchangeSaldos, órdenes, retirosClave y firma
Genesis APISpreads, libros de órdenes, funding, DEX, on-chain, mercados de predicciónClave, solo lectura

Una petición al endpoint /arbitrage/spot-spot de Genesis API devuelve los spreads calculados entre los mercados spot de más de 20 exchanges CEX, con indicadores de depósito y retiro. Cada petición es un HTTP GET, cada respuesta es JSON, y los parámetros y campos de cada endpoint están en la documentación.

Véase también: API de criptomonedas: tipos y cómo elegir, inicio rápido en la documentación, rate limit, lección: qué es una API de criptomonedas.

Preguntas y respuestas

¿Necesito un SDK para trabajar con una API?

Si la API usa HTTP, sirve cualquier cliente HTTP. Para Genesis API bastan curl, requests en Python o el fetch integrado de JavaScript.

¿Puedo operar a través de Genesis API?

No. Genesis API solo entrega datos. Las órdenes se colocan en el exchange a mano o mediante la API del propio exchange con su clave, bajo tu responsabilidad.