← All skills
Tencent SkillHub Β· Finance & Trading

0xArchive

Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3. Covers orderbooks, trades, candles, funding rates, open intere...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Query historical crypto market data from 0xArchive across Hyperliquid, Lighter.xyz, and HIP-3. Covers orderbooks, trades, candles, funding rates, open intere...

⬇ 0 downloads β˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.3.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 16 sections Open source page

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 formatExamplesHyperliquid/v1/hyperliquidUPPERCASEBTC, ETH, SOLHIP-3/v1/hyperliquid/hip3Case-sensitive, prefix:NAMEkm:US500, xyz:XYZ100Lighter/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 } }

Hyperliquid (/v1/hyperliquid)

EndpointParamsNotesGET /instruments--List all instrumentsGET /instruments/{symbol}--Single instrument detailsGET /orderbook/{symbol}timestamp, depthLatest or at timestampGET /orderbook/{symbol}/historystart, end, limit, cursor, depthHistorical snapshotsGET /trades/{symbol}start, end, limit, cursorTrade historyGET /candles/{symbol}start, end, limit, cursor, intervalOHLCV candlesGET /funding/{symbol}/current--Current funding rateGET /funding/{symbol}start, end, limit, cursor, intervalFunding rate historyGET /openinterest/{symbol}/current--Current open interestGET /openinterest/{symbol}start, end, limit, cursor, intervalOI historyGET /liquidations/{symbol}start, end, limit, cursorLiquidation eventsGET /liquidations/{symbol}/volumestart, end, limit, cursor, intervalAggregated liquidation volume (USD)GET /liquidations/user/{address}start, end, limit, cursor, coinLiquidations for a userGET /freshness/{symbol}--Data freshness per data typeGET /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. EndpointParamsNotesGET /instruments--List HIP-3 instrumentsGET /instruments/{coin}--Single instrumentGET /orderbook/{coin}timestamp, depthRequires Pro+ tierGET /orderbook/{coin}/historystart, end, limit, cursor, depthRequires Pro+ tierGET /trades/{coin}start, end, limit, cursorTrade historyGET /trades/{coin}/recentlimitRecent trades (no time range needed)GET /candles/{coin}start, end, limit, cursor, intervalOHLCV candlesGET /funding/{coin}/current--Current funding rateGET /funding/{coin}start, end, limit, cursor, intervalFunding historyGET /openinterest/{coin}/current--Current OIGET /openinterest/{coin}start, end, limit, cursor, intervalOI historyGET /freshness/{coin}--Data freshness per data typeGET /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. EndpointParamsNotesGET /instruments--List Lighter instrumentsGET /instruments/{symbol}--Single instrumentGET /orderbook/{symbol}timestamp, depthLatest or at timestampGET /orderbook/{symbol}/historystart, end, limit, cursor, depth, granularityDefault granularity: checkpointGET /trades/{symbol}start, end, limit, cursorTrade historyGET /trades/{symbol}/recentlimitRecent trades (no time range needed)GET /candles/{symbol}start, end, limit, cursor, intervalOHLCV candlesGET /funding/{symbol}/current--Current funding rateGET /funding/{symbol}start, end, limit, cursor, intervalFunding historyGET /openinterest/{symbol}/current--Current OIGET /openinterest/{symbol}start, end, limit, cursor, intervalOI historyGET /freshness/{symbol}--Data freshness per data typeGET /summary/{symbol}--Combined market summary (price, funding, OI)GET /prices/{symbol}start, end, limit, cursor, intervalMark/oracle price history

Data Quality (/v1/data-quality)

EndpointParamsNotesGET /status--System health statusGET /coverage--Coverage summary, all exchangesGET /coverage/{exchange}--Coverage for one exchangeGET /coverage/{exchange}/{symbol}from, toSymbol-level coverage + gapsGET /incidentsstatus, exchange, since, limit, offsetList incidentsGET /incidents/{id}--Single incidentGET /latency--Ingestion latency metricsGET /slayear, monthSLA compliance report

Web3 Authentication (/v1)

Get API keys programmatically using an Ethereum wallet (SIWE). No API key required for these endpoints. EndpointParamsNotesPOST /auth/web3/challengeaddress (wallet address)Returns SIWE message to signPOST /web3/signupmessage, signatureReturns free-tier API keyPOST /web3/keysmessage, signatureList all keys for walletPOST /web3/keys/revokemessage, signature, key_idRevoke a keyPOST /web3/subscribetier (build or pro), payment-signature headerx402 USDC subscription (see flow below) Free-tier flow: Call /auth/web3/challenge with wallet address β†’ sign the returned message with personal_sign (EIP-191) β†’ submit to /web3/signup with the message and signature β†’ receive API key. Paid-tier flow (x402): POST /web3/subscribe with { "tier": "build" } β†’ server returns 402 with payment.amount (micro-USDC), payment.pay_to (treasury address), payment.network. Sign an EIP-712 TransferWithAuthorization (EIP-3009) on USDC Base: Domain: { name: "USD Coin", version: "2", chainId: 8453, verifyingContract: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" } Type: TransferWithAuthorization(address from, address to, uint256 value, uint256 validAfter, uint256 validBefore, bytes32 nonce) Message: { from: <wallet>, to: <pay_to>, value: <amount>, validAfter: 0, validBefore: <now+3600>, nonce: <32 random bytes hex> } Build x402 v2 payment payload: { "x402Version": 2, "payload": { "signature": "0x<EIP-712 signature hex>", "authorization": { "from": "0x<wallet>", "to": "0x<pay_to from step 1>", "value": "<amount as string>", "validAfter": "0", "validBefore": "<unix timestamp as string>", "nonce": "0x<64 hex chars>" } } } Base64-encode the JSON and retry: POST /web3/subscribe with { "tier": "build" } and header payment-signature: <base64 payload> β†’ receive API key + subscription. Important: All authorization values (value, validAfter, validBefore) must be strings, not numbers. See scripts/web3_subscribe.py for a complete working Python implementation.

Common Parameters

ParamTypeDescriptionstartintStart 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 LimitFree$0BTC only (HIP-3: km:US500 only)20 levels--30 days15 RPSBuild$49/moAll50 levelscheckpoint, 30s, 10s1 year50 RPSPro$199/moAll100 levels+ 1sFull history150 RPSEnterpriseCustomAllFull depth+ tickFull historyCustom

Error Handling

HTTP StatusMeaningAction400Bad request / validation errorCheck params (missing start/end, invalid interval)401Missing or invalid API keySet $OXARCHIVE_API_KEY403Tier restrictionUpgrade plan (e.g., non-BTC coin on Free tier)404Symbol not foundCheck coin name spelling and exchange429Rate 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 '.'

Category context

Trading, swaps, payments, treasury, liquidity, and crypto-financial operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
1 Docs
  • SKILL.md Primary doc