Skills are reusable local instructions for agent hosts and harnesses that should load 0xArchive route rules, auth handling, and request patterns on demand. A Skill is aDocumentation Index
Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
Use this file to discover all available pages before exploring further.
SKILL.md workflow package. It is not a protocol, not a coding agent, and not a replacement for the REST API. It teaches a compatible host how to choose 0xArchive routes, keep venue families separate, run bounded curl requests, parse JSON with jq, and preserve request IDs.
Discovery Contract
Use the well-known indexes for machine discovery:| Discovery surface | Use |
|---|---|
https://docs.0xarchive.io/.well-known/skills/index.json | Mintlify-generated original Skill index with non-empty descriptions and files entries |
https://docs.0xarchive.io/.well-known/agent-skills/index.json | Agent-skill index with payload URLs, descriptions, and SHA-256 digests |
/.well-known/agent-skills/{skillName}/skill.md | Mintlify-generated agent-skill Markdown payloads referenced by the agent-skill index |
/skill.md as the public Markdown Skill package. Mintlify may reserve that route for generated Skill discovery JSON, so docs, agents, and llms files should use the well-known indexes instead.
Requirements
| Requirement | Value |
|---|---|
| API key environment variable | OXARCHIVE_API_KEY |
| Local tools | curl, jq |
| Fastest OpenClaw path | openclaw install 0xarchive |
| Route/schema companion | OpenAPI |
| Machine discovery | /.well-known/skills/index.json and /.well-known/agent-skills/index.json |
Install
- OpenClaw
- Claude Code
- Codex
- Other hosts
What The Skill Does
Choose the venue family
Separate Hyperliquid core, Hyperliquid Spot, HIP-3, HIP-4, and Lighter before choosing routes.
Run bounded requests
Use shell-backed
curl patterns with explicit symbols, windows, limits, and auth headers.Skill Versus MCP Server Versus CLI
| Surface | Best fit |
|---|---|
| Skill | Reusable instructions and request recipes inside a skill-capable host or OpenClaw workflow |
| MCP Server | Typed tool calls in an MCP-capable client |
| CLI | Shell-native oxa commands for scripts, CI, cron, notebooks, and coding-agent terminals |
| OpenAPI | Route and schema contract for codegen, review, and route selection |
Skill Execution Packet
Ask the host to collect the venue family, symbol, data family, route or command, freshness check, expected output, and widening limit before it runs the Skill. That packet keeps the Skill from turning a vague market-data prompt into a broad shell job.| Packet field | Why it matters |
|---|---|
| Venue family | Keeps Hyperliquid core, Spot, HIP-3, HIP-4, and Lighter separate |
| Symbol and window | Keeps curl requests bounded and reproducible |
| Data family | Chooses order books, trades, candles, funding, OI, L3, L4, or freshness deliberately |
| Output goal | Distinguishes inspection, script output, backtest input, dashboard data, and support context |
| Stop condition | Prevents pagination, exports, or wider loops until the first response is inspected |
Why 0xArchive Fits
0xArchive’s Skill package is useful when the agent already has a shell and needs repeatable market-data procedures rather than a full generated client. It keeps Hyperliquid core, Hyperliquid Spot, HIP-3, HIP-4, and Lighter route families explicit, then routes execution through authenticated HTTP calls.Operational Boundaries
The Skill should teach the agent how to choose routes and run small, inspectable requests. It should not hide broad shell mutation, install arbitrary dependencies, or make unsupported product claims. Use it for bounded market-data retrieval, freshness checks, and route selection. Use MCP Server when the host needs typed tool calls, CLI when the workflow should become a command, and SDKs or REST when the code belongs inside an application.Prompt Shape
Good Skill prompts name the venue family, symbol, data family, and output goal. For example: “Use 0xArchive to check freshness for Lighter BTC, then pull the first 50 trades if the freshness check is acceptable.” That gives the Skill enough context to choose/v1/lighter/*, use the key safely, parse the response, and preserve the request ID.