공지 사항

저희는 엔드포인트의 이전 버전 호환성을 보장할 수 없습니다. 많은 수요로 인해 API 직접 접근을 위한 문서를 공개하지만, 이는 API를 보다 완전히 공개하기 위한 시범적인 조치입니다. 그럼에도 불구하고, API를 사용하시는 분들을 최대한 지원하려고 노력할 것이므로, 저희 API를 인프라에 상당히 통합한 경우 변동 사항에 대해 경고를 드릴 수 있도록 알려주시기 바랍니다.

인증

아캄의 API를 사용하기 위해서는 유효한 API 키를 요청 헤더에 제공해야 합니다. 헤더 키는 API-Key 입니다. 현재 우리의 UI나 API를 통해 API 키를 생성할 방법은 없으며, 수동으로 제공합니다. API 키가 필요하시면 알려주십시오.

엔드포인트

우리의 루트 URL은 [<https://api.arkhamintelligence.com입니다>](https://api.arkhamintelligence.com입니다/). 우리의 API 요청은 초당 5개의 요청으로 제한되며, 이 한도를 초과하면 소량의 추가 버스트 허용량이 있습니다. 향후 이 한도를 낮출 수 있으므로, 여유를 두고 사용하시길 권장합니다. 기본 한도를 일관되게 초과하는 경우 여기에서 한도 증가를 신청할 수 있습니다. 여기에 문서화된 엔드포인트는 완전하지 않으며, 더 많은 요청이 있을 경우 추가할 예정입니다.

GET /transfers

매개변수

모두 쿼리 매개변수로 사용

• base
  • 타입: string[]
  • 필수사항
  • 트랜잭션의 발신자 또는 수신자를 확인하려는 엔티티/주소
  • 주소 또는 엔티티 ID여야 합니다(엔티티 ID는 /explorer/엔티티 페이지의 URL을 확인하여 찾을 수 있습니다). 안타깝게도 저희가 보유한 모든 엔티티 아이디 목록을 노출하지는 않지만, 이름을 알고 있다면 검색창을 통해 쉽게 찾을 수 있습니다. 하지만 보통은 Alameda Research -> alameda-research와 같은 이름의 축약된 버전일 뿐입니다.
  • 여러 주소를 포함하려면 쉼표로 구분하면 됩니다. 주소와 엔티티를 혼합하여 포함할 수도 있습니다. 예를 들면 다음과 같습니
    • ftx
    • ftx,binance
    • 0x123...,0x456...,alameda-research
  • 엔티티를 생성하는 경우 여기에 해당 엔티티의 ID를 전달할 수도 있습니다.
• chains
  • 타입: string[]
  • 선택 사항, 비어 있으면 기본적으로 모든 체인으로 설정됩니다.
  • 지원되는 체인: ethereum, bsc, polygon, arbitrum_one, avalanche, optimism, bitcoin, tron, base, flare.
• flow
  • 타입: "in" | "out" | "all"
  • 기본값: all
  • 흐름은 base과 관련된 것이므로 예를 들어 out을 선택하면 다른 필터에 관계없이 base에서 발생하는 트랜잭션만 표시됩니다.
• from
  • 타입: string[]
  • 특정 엔티티/주소의 트랜잭션만 필터링합니다. 여러 개를 포함하면 지정된 엔티티/주소 중 모든 엔티티/주소에서 베이스에 지정된 주소/엔티티로 보낸 트랜잭션을 가져옵니다.
  • 법인 ID와 주소 (base에서와 동일) 외에도 법인 유형과 예치금에 대한 거래소 ID도 포함할 수 있습니다.예시 :
    • type:cex 는 중앙화된 거래소의 모든 거래를 제공합니다.
    • deposit:binance 는 바이낸스 입금 주소에 대한 모든 거래를 제공합니다. 거래소뿐만 아니라 입금 주소 패턴을 사용하는 모든 주체(커스터디 플랫폼, OTC 데스크, 도박 사이트 등)에 대해 ID를 전달할 수 있습니다. 특정 법인의 핫월렛을 식별한 경우, 해당 법인의 입금을 자동 라벨링하여 쿼리할 수 있습니다.
    • deposit:all 모든 입금 주소로 거래가 가능합니다.
  • 옵션 앞에! 를 붙이면 해당 옵션이 무효화됩니다. 예를 들어 type:cex,!binance는 "중앙화된 거래소로 전송하지만 바이낸스로 전송하지 않음"으로 필터링합니다. 이 옵션은 유형, 엔티티, 주소에는 사용할 수 있지만 예금 엔티티 ID에는 사용할 수 없습니다.
  • 모든 포지티브 필터는 내부적으로 OR로 결합되며, 모든 네거티브 필터는 내부적으로 AND로 결합되어 포지티브 필터에 대해 서로 반대됩니다. 따라서 type:cex,deposit:all,!binance,!huobi는 중앙화된 거래소 또는 모든 입금 주소로의 거래는 필터링하지만 후오비나 바이낸스로의 거래는 필터링하지 않습니다.
• to
  • from 와 같습니다
• tokens
  • 타입: string[]
  • 특정 토큰과 관련된 거래만 필터링합니다. 저희는 가격 책정을 위해 CoinGecko를 사용하므로 코인게코 ID 또는 토큰 주소 목록입니다.
• timeGte
  • 타입: number (유닉스 밀리초 타임스탬프)
  • 블록 타임스탬프가 특정 시간보다 크거나 같은 트랜잭션을 필터링합니다.
• timeLte
  • timeGte 와 같습니다
• timeLast
  • 타입: string
  • 예시: 지난 1시간은 1h, 지난 3일은 3d, 지난 10분은 10m.
  • 특정 기간, 숫자 및 기간 단위로 지정된 기간 내의 전송을 필터링합니다. 기본적으로 시간Gte를 설정하기 위한 약어입니다. 지원되는 기간 단위는 s(초), m(분), h(시간), d(일), w(주), M(월) 및 y(년)입니다. d는 24h, w는 7d, M은 30d, y는 365d이므로 윤초/연도 같은 것은 무시됩니다.