Avisos legales

No podemos garantizar la compatibilidad retroactiva de nuestros endpoints. Estamos publicando esta documentación debido a la gran demanda de acceso directo a la API, y esto es solo un piloto para lanzar nuestra API de manera más completa. Dicho esto, haremos todo lo posible para adaptarnos y ayudar a cualquiera que utilice nuestra API, así que si integras significativamente nuestra API en tu infraestructura, háznoslo saber para poder avisarte sobre posibles cambios disruptivos.

Autenticación

Para autenticarte con la API de Arkham, solo necesitas proporcionar una clave API válida en el encabezado de tu solicitud. La clave del encabezado es API-Key. Actualmente no hay forma de generar una clave API a través de nuestra interfaz de usuario o API, las entregamos manualmente. Si deseas una clave API, avísanos.

Endpoints

Nuestra URL raíz es https://api.arkhamintelligence.com.

Las peticiones a nuestra API están limitadas a 5 peticiones por segundo con una pequeña tolerancia adicional sí superas ese límite. Es posible que reduzcamos este límite en el futuro, te recomendamos mantenerte por debajo de ese límite.

Si constantemente superas el límite de peteciones predeterminado que hemos establecido para nuestra API, puedes solicitar un aumento del límite de velocidad aquí.

Los endpoints documentados aquí no son exhaustivos, los iremos ampliando a medida que se soliciten más.

GET /transfers

Parámetros

Todos como parámetros de consulta

• base
  • Tipo: string[]
  • Requerido
  • Entidades/direcciones de las que quieres ver transacciones, ya sea desde o hacia
  • Debe ser una dirección o id de entidad (puedes encontrar ids de entidades mirando la URL de una página /explorador/entity). Desafortunadamente, no disponemos de una lista de todos los entity_ids que tenemos, aunque nuestra barra de búsqueda es bastante buena si conoces el nombre. Pero generalmente es solo una versión simplificada del nombre: Alameda Research -> alameda-research.
  • Para incluir múltiples elementos, basta con separarlos por comas. Incluso puedes incluir una combinación de direcciones y entidades. Por ejemplo:
    • ftx
    • ftx,binance
    • 0x123...,0x456...,alameda-research
  • Si creas una entidad, también puedes pasar su ID aquí.
• chains
  • Tipo: string[]
  • Opcional, si está vacío, se establecerá por defecto en todas las cadenas
  • Cadenas admitidas: ethereum, bsc, polygon, arbitrum_one, avalanche, optimism, bitcoin, tron, base, flare.
• flow
  • Tipo: "in" | "out" | "all"
  • Predeterminado: all
  • El flujo está en relación con base, por lo que si eliges, por ejemplo,out, solo verás transacciones que salen de base independientemente de los demás filtros.
• from
  • Tipo: string[]
  • Filtro para obtener sólo transacciones de determinadas entidades/direcciones. Si incluye múltiples obtendrá transacciones de cualquiera de las entidades/direcciones especificadas a cualquiera de las direcciones/entidades especificadas en base.
  • Además de los ID de entidad y direcciones (igual que en base), también puedes incluir tipos de entidad e IDs de intercambio para los depósitos. Por ejemplo:
    • type:cex te dará todas las transacciones de las plataformas de intercambio centralizadas
    • deposit:binance te dará todas las transacciones a direcciones de depósito de binance. Puedes pasar un ID para cualquier entidad que use un patrón de dirección de depósito, no sólo intercambios (plataformas de custodia, tratos OTC, páginas de apuestas, etc.). Si hemos identificado una billetera caliente para una entidad, etiquetamos automáticamente los depósitos y puedes consultarlos.
    • deposit:all te devolverá transacciones a cualquier dirección de depósito.
  • Si antepone el prefijo ! a una opción, ésta se anulará. Por ejemplo, type:cex,!binance filtrará "a una plataformas de intercambio centralizadas pero no de binance". Esta opción está disponible para tipos, entidades y direcciones, pero no para IDs de entidad de depósito.
  • Todos los filtros positivos se combinan internamente con un OR, y todos los filtros negativos se combinan internamente con un AND, y en contra de los filtros positivos. Por lo tanto, type:cex,deposit:all,!binance,!huobi filtrará las transacciones hacia plataformas de intercambio centralizadas o cualquier dirección de depósito, pero no hacia huobi o binance.
• to
  • Igual que from
• tokens
  • Tipo: string[]
  • Filtra solo transacciones que involucran tokens específicos. Utilizamos CoinGecko para los precios, por lo que esta es una lista de IDs de CoinGecko o direcciones de token.
• timeGte
  • Tipo: number (marca de tiempo Unix en milisegundos)
  • Filtra transacciones con un block_timstamp mayor o igual a una hora determinada.
• timeLte
  • Igual que timeGte