본문으로 건너뛰기
cccskills
무료GitHub에 공개

0xarchive

Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3. Covers orderbooks, trades, candles, funding rates, open interest, liquidations, and data quality. Use when the user asks about crypto market data, orderbooks, trades, funding rates, or historical prices on Hyperliquid, Lighter.xyz, or HIP-3.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(2)

  • SKILL.md12.8 KB
  • _meta.json456 B

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

0xArchive API Skill

Query historical and real-time crypto market data from 0xArchive using curl. Three exchanges are supported: Hyperliquid (perps DEX), Lighter.xyz (order-book DEX), and HIP-3 (Hyperliquid builder perps). Data types: orderbooks, trades, candles, funding rates, open interest, liquidations, and data quality metrics.

Authentication

All endpoints require the x-api-key header. The key is read from $OXARCHIVE_API_KEY.

curl -s -H "x-api-key: $OXARCHIVE_API_KEY" "https://api.0xarchive.io/v1/..."

Exchanges & Coin Naming

ExchangePath prefixCoin formatExamples
Hyperliquid/v1/hyperliquidUPPERCASEBTC, ETH, SOL
HIP-3/v1/hyperliquid/hip3Case-sensitive, prefix:NAMEkm:US500, xyz:XYZ100
Lighter/v1/lighterUPPERCASEBTC, ETH

Hyperliquid and Lighter auto-uppercase the symbol server-side. HIP-3 coin names are passed through as-is.

Timestamps

All timestamps are Unix milliseconds. Use these shell helpers:

NOW=$(( $(date +%s) * 1000 ))
HOUR_AGO=$(( NOW - 3600000 ))
DAY_AGO=$(( NOW - 86400000 ))
WEEK_AGO=$(( NOW - 604800000 ))

Response Format

Every response follows this shape:

{
  "success": true,
  "data": [ ... ],
  "meta": {
    "count": 100,
    "request_id": "uuid",
    "next_cursor": "1706000000000"   // present when more pages exist
  }
}

Endpoint Reference

Hyperliquid (/v1/hyperliquid)

EndpointParamsNotes
GET /instruments--List all instruments
GET /instruments/{symbol}--Single instrument details
GET /orderbook/{symbol}timestamp, depthLatest or at timestamp
GET /orderbook/{symbol}/historystart, end, limit, cursor, depthHistorical snapshots
GET /trades/{symbol}start, end, limit, cursorTrade history
GET /candles/{symbol}start, end, limit, cursor, intervalOHLCV candles
GET /funding/{symbol}/current--Current funding rate
GET /funding/{symbol}start, end, limit, cursor, intervalFunding rate history
GET /openinterest/{symbol}/current--Current open interest
GET /openinterest/{symbol}start, end, limit, cursor, intervalOI history
GET /liquidations/{symbol}start, end, limit, cursorLiquidation events
GET /liquidations/{symbol}/volumestart, end, limit, cursor, intervalAggregated liquidation volume (USD)
GET /liquidations/user/{address}start, end, limit, cursor, coinLiquidations for a user
GET /freshness/{symbol}--Data freshness per data type
GET /summary/{symbol}--Combined market summary (price, funding, OI, volume, liquidations)
GET /prices/{symbol}start, end, limit, cursor, intervalMark/oracle/mid price history

HIP-3 (/v1/hyperliquid/hip3)

Coin names are case-sensitive (e.g., km:US500). No liquidation endpoints. Orderbook requires Pro+ tier.

EndpointParamsNotes
GET /instruments--List HIP-3 instruments
GET /instruments/{coin}--Single instrument
GET /orderbook/{coin}timestamp, depthRequires Pro+ tier
GET /orderbook/{coin}/historystart, end, limit, cursor, depthRequires Pro+ tier
GET /trades/{coin}start, end, limit, cursorTrade history
GET /trades/{coin}/recentlimitRecent trades (no time range needed)
GET /candles/{coin}start, end, limit, cursor, intervalOHLCV candles
GET /funding/{coin}/current--Current funding rate
GET /funding/{coin}start, end, limit, cursor, intervalFunding history
GET /openinterest/{coin}/current--Current OI
GET /openinterest/{coin}start, end, limit, cursor, intervalOI history
GET /freshness/{coin}--Data freshness per data type
GET /summary/{coin}--Combined market summary (price, funding, OI)
GET /prices/{coin}start, end, limit, cursor, intervalMark/oracle/mid price history

Lighter (/v1/lighter)

Same data types as Hyperliquid except: no liquidations. Adds granularity on orderbook history and /recent trades.

EndpointParamsNotes
GET /instruments--List Lighter instruments
GET /instruments/{symbol}--Single instrument
GET /orderbook/{symbol}timestamp, depthLatest or at timestamp
GET /orderbook/{symbol}/historystart, end, limit, cursor, depth, granularityDefault granularity: checkpoint
GET /trades/{symbol}start, end, limit, cursorTrade history
GET /trades/{symbol}/recentlimitRecent trades (no time range needed)
GET /candles/{symbol}start, end, limit, cursor, intervalOHLCV candles
GET /funding/{symbol}/current--Current funding rate
GET /funding/{symbol}start, end, limit, cursor, intervalFunding history
GET /openinterest/{symbol}/current--Current OI
GET /openinterest/{symbol}start, end, limit, cursor, intervalOI history
GET /freshness/{symbol}--Data freshness per data type
GET /summary/{symbol}--Combined market summary (price, funding, OI)
GET /prices/{symbol}start, end, limit, cursor, intervalMark/oracle price history

Data Quality (/v1/data-quality)

EndpointParamsNotes
GET /status--System health status
GET /coverage--Coverage summary, all exchanges
GET /coverage/{exchange}--Coverage for one exchange
GET /coverage/{exchange}/{symbol}from, toSymbol-level coverage + gaps
GET /incidentsstatus, exchange, since, limit, offsetList incidents
GET /incidents/{id}--Single incident
GET /latency--Ingestion latency metrics
GET /slayear, monthSLA compliance report

Common Parameters

ParamTypeDescription
startintStart timestamp (Unix ms). Defaults to 24h ago.
endintEnd timestamp (Unix ms). Defaults to now.
limitintMax records. Default 100, max 1000 (max 10000 for candles).
cursorstringPagination cursor from meta.next_cursor.
intervalstringCandle interval: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w. Default: 1h. For OI/funding: 5m, 15m, 30m, 1h, 4h, 1d. Omit for raw data.
depthintOrderbook depth (number of price levels per side).
granularitystringLighter orderbook resolution: checkpoint (default), 30s, 10s, 1s, tick.

Smart Defaults

When the user does not specify a time range, default to the last 24 hours:

NOW=$(( $(date +%s) * 1000 ))
DAY_AGO=$(( NOW - 86400000 ))

For candles with no explicit range, default to a range that makes sense for the interval (e.g., last 7 days for 4h candles, last 30 days for 1d candles).

Pagination

When meta.next_cursor is present in the response, more data is available. Append &cursor=VALUE to fetch the next page:

# First page
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/trades/BTC?start=$START&end=$END&limit=1000"

# Next page (use next_cursor from previous response)
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/trades/BTC?start=$START&end=$END&limit=1000&cursor=1706000000000_12345"

Tier Limits

TierPriceCoinsOrderbook DepthLighter GranularityHistorical DepthRate Limit
Free$0BTC only (HIP-3: km:US500 only)20 levels--30 days15 RPS
Build$49/moAll50 levelscheckpoint, 30s, 10s1 year50 RPS
Pro$199/moAll100 levels+ 1sFull history150 RPS
EnterpriseCustomAllFull depth+ tickFull historyCustom

Error Handling

HTTP StatusMeaningAction
400Bad request / validation errorCheck params (missing start/end, invalid interval)
401Missing or invalid API keySet $OXARCHIVE_API_KEY
403Tier restrictionUpgrade plan (e.g., non-BTC coin on Free tier)
404Symbol not foundCheck coin name spelling and exchange
429Rate limitedBack off and retry

Error responses return { "code": 400, "error": "description" }.

Example Queries

# List Hyperliquid instruments
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/instruments" | jq '.data | length'

# Current BTC orderbook (top 10 levels)
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/orderbook/BTC?depth=10" | jq '.data'

# ETH trades from the last hour
NOW=$(( $(date +%s) * 1000 )); HOUR_AGO=$(( NOW - 3600000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/trades/ETH?start=$HOUR_AGO&end=$NOW&limit=100" | jq '.data'

# SOL 4h candles for the last week
NOW=$(( $(date +%s) * 1000 )); WEEK_AGO=$(( NOW - 604800000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/candles/SOL?start=$WEEK_AGO&end=$NOW&interval=4h" | jq '.data'

# Current BTC funding rate
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/funding/BTC/current" | jq '.data'

# BTC open interest aggregated to 1h intervals (last week)
NOW=$(( $(date +%s) * 1000 )); WEEK_AGO=$(( NOW - 604800000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/openinterest/BTC?start=$WEEK_AGO&end=$NOW&interval=1h" | jq '.data'

# ETH funding rates aggregated to 4h intervals (last 30 days)
NOW=$(( $(date +%s) * 1000 )); MONTH_AGO=$(( NOW - 2592000000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/funding/ETH?start=$MONTH_AGO&end=$NOW&interval=4h" | jq '.data'

# HIP-3 km:US500 candles (last 24h, 1h interval)
NOW=$(( $(date +%s) * 1000 )); DAY_AGO=$(( NOW - 86400000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/hip3/candles/km:US500?start=$DAY_AGO&end=$NOW&interval=1h" | jq '.data'

# Lighter BTC orderbook history (30s granularity, last hour)
NOW=$(( $(date +%s) * 1000 )); HOUR_AGO=$(( NOW - 3600000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/lighter/orderbook/BTC/history?start=$HOUR_AGO&end=$NOW&granularity=30s&limit=100" | jq '.data'

# System health status
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/data-quality/status" | jq '.'

# SLA report for current month
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/data-quality/sla" | jq '.'

# BTC market summary (price, funding, OI, volume, liquidations in one call)
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/summary/BTC" | jq '.data'

# BTC data freshness (lag per data type)
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/freshness/BTC" | jq '.data'

# BTC price history (mark/oracle/mid) aggregated to 1h
NOW=$(( $(date +%s) * 1000 )); DAY_AGO=$(( NOW - 86400000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/prices/BTC?start=$DAY_AGO&end=$NOW&interval=1h" | jq '.data'

# BTC liquidation volume aggregated to 4h buckets
NOW=$(( $(date +%s) * 1000 )); WEEK_AGO=$(( NOW - 604800000 ))
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/hyperliquid/liquidations/BTC/volume?start=$WEEK_AGO&end=$NOW&interval=4h" | jq '.data'

# Data coverage for Hyperliquid BTC
curl -s -H "x-api-key: $OXARCHIVE_API_KEY" \
  "https://api.0xarchive.io/v1/data-quality/coverage/hyperliquid/BTC" | jq '.'

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

0protocol

무료

Agents can sign plugins, rotate credentials without losing identity, and publicly attest to behavior.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

Calculate ROI for AI-as-a-Service (managed AI agents). Estimates cost savings, efficiency gains, and payback period for deploying AI agents across business operations. Use when evaluating whether managed AI agents make financial sense for a company.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

Design, build, deploy, and operate production AI agent systems — single agents, multi-agent teams, and autonomous swarms. Complete methodology from agent architecture through orchestration, memory systems, safety guardrails, and operational excellence.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

Design, build, test, document, and secure production-grade APIs. Covers the full lifecycle from schema design through deployment, monitoring, and versioning. Use when designing new APIs, reviewing existing ones, generating OpenAPI specs, building test suites, or debugging production issues.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

Turn your AI agent into a business automation architect. Design, document, implement, and monitor automated workflows across sales, ops, finance, HR, and support — no n8n or Zapier required.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

Complete career acceleration system — from self-assessment to offer negotiation. Covers career strategy, job search operations, resume/CV optimization, interview preparation, salary negotiation, career transitions, and long-term growth planning. Works for any role, any level, any industry.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

johnalbertini14-glitch/openclaw-skills22026년 2월 26일 업데이트

johnalbertini14-glitch의 스킬 모두 보기

이 스킬의 문제 신고