Disclaimer

Non possiamo garantire la retro compatibilità dei nostri endpoint. Stiamo rilasciando questa documentazione vista la grande richiesta di accesso diretto alle API, e questo è solo un progetto pilota per rilasciare le nostre API in modo più completo. Detto questo, faremo del nostro meglio per essere accomodanti con chiunque utilizzi le nostre API, quindi se integrate in modo significativo le nostre API nella vostra infrastruttura, vi preghiamo di farcelo sapere in modo da avvisarvi di potenziali aggiornamenti che possono causare malfunzionamenti.

Autenticazione

Tutto ciò che devi fare per autenticarti con le API di Arkham è fornire una chiave API valida nell'intestazione della tua richiesta. La header key è API-Key. Attualmente non c'è modo di generare una chiave API attraverso l'interfaccia utente o API, la forniamo manualmente. Se desideri una chiave API, faccelo sapere.

Endpoint

Il nostro URL principale è https://api.arkhamintelligence.com.

Le richieste alla nostre API sono limitate a 5 al secondo, con una piccola soglia di tolleranza aggiuntiva in caso di superamento. Potremmo abbassare questo limite in futuro quindi è meglio cercare di rimanerne al di sotto.

Se si supera costantemente il limite predefinito che abbiamo impostato per la nostra API, è possibile richiedere un aumento del limite qui.

Gli endpoint qui documentati non sono esaustivi: verranno aggiunti man mano che ne verranno richiesti altri.

GET /transfers

Parametri

Tutti come parametri di query

• base
  • Tipo: string[]
  • Richiesto
  • Entità/indirizzi da cui si desidera visualizzare le transazioni da o verso
  • Deve essere un indirizzo o un id di entità (si possono trovare gli id di entità guardando l'url di una pagina /explorer/entity). Purtroppo non forniamo un elenco di tutti gli ID_entità che abbiamo, anche se la nostra barra di ricerca è abbastanza buona se si conosce il nome. Ma di solito è solo una versione trasformata in slug del nome: Alameda Research -> alameda-research.
  • Per includere più indirizzi, basta separarli con una virgola. Si può anche includere un mix di indirizzi ed entità. Ad esempio:
    • ftx
    • ftx,binance
    • 0x123...,0x456...,alameda-research
  • Se si crea un'entità, si può anche passare il suo ID qui.
• chains
  • Tipo: string[]
  • Facoltativo, se lasciato vuoto sarà impostato su tutte le reti.
  • Reti supportate: ethereum, bsc, polygon, arbitrum_one, avalanche, optimism, bitcoin, tron, base, flare.
• flow
  • Tipo: "in" | "out" | "all"
  • Predefinito: all
  • Il flusso è rispetto a base perciò se utilizzi, ad esempio, out vedrai solo transazioni in arrivo da base indipendentemente dagli altri tuoi filtri
• from

  • Tipo: string[]

  • Filtra solo le transazioni provenienti da determinate entità/indirizzi. Se si includono più elementi, si otterranno le transazioni da qualsiasi entità/indirizzo specificato a qualsiasi indirizzo/entità specificato nella base

  • Oltre agli ID delle entità e agli indirizzi (come in base), è possibile includere anche i tipi di entità e gli ID degli scambi per i depositi. Ad esempio:

    • type:cex ti fornirà tutte le transazioni dagli exchange centralizzati
    • deposit:binance ti fornirà tutte le transazioni verso gli indirizzi di deposito di Binance. È possibile inserire un ID per qualsiasi entità che utilizzi un modello di indirizzo di deposito, non solo per gli exchange (piattaforme di custodia,OTC desk, siti di gioco d'azzardo, ecc.). Se abbiamo identificato un hot wallet per un'entità, etichettiamo automaticamente i depositi per questa entità e puoi eseguire una query per trovarli.
    • deposit:all ti darà le transazioni a qualsiasi indirizzo di deposito.

  • Se si antepone un prefisso a un'opzione con !, questo renderà l’opzione negativa. Ad esempio, type:cex,!binance filtrerà per "agli exchange centralizzati ma non a Binance". Questa opzione è disponibile per tipi, entità e indirizzi, ma non per gli ID delle entità di deposito.

  • Tutti i filtri positivi sono internamente impostati insieme come OR e tutti i filtri negativi sono internamente impostati con AND l'uno contro l'altro e contro i filtri positivi. Quindi, type:cex,deposit:all,!binance,!huobi filtrerà le transazioni verso gli exchange centralizzati o qualsiasi indirizzo di deposito, ma non verso huobi o binance.

• to
  • Come from
• tokens
  • Tipo: string[]
  • Filtro per le sole transazioni che coinvolgono particolari token. Utilizziamo CoinGecko per la determinazione dei prezzi, quindi si tratta di un elenco di ID CoinGecko o indirizzi di token.
• timeGte
  • Tipo: number (timestamp unix millisecondi)
  • Filtra le transazioni con un block_timstamp maggiore o uguale a un certo tempo.
• timeLte
  • Uguale a timeGte