{"id":48600800,"url":"https://github.com/zeriontech/zerion-ai","last_synced_at":"2026-04-08T22:02:13.525Z","repository":{"id":348390252,"uuid":"1176373356","full_name":"zeriontech/zerion-ai","owner":"zeriontech","description":"Zerion for AI agents and developers: hosted MCP docs, wallet-analysis skill, and a JSON-first CLI.","archived":false,"fork":false,"pushed_at":"2026-04-01T00:22:30.000Z","size":199,"stargazers_count":0,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-01T01:55:08.109Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zeriontech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-09T00:37:08.000Z","updated_at":"2026-03-25T18:16:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zeriontech/zerion-ai","commit_stats":null,"previous_names":["zeriontech/zerion-ai"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/zeriontech/zerion-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeriontech%2Fzerion-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeriontech%2Fzerion-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeriontech%2Fzerion-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeriontech%2Fzerion-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zeriontech","download_url":"https://codeload.github.com/zeriontech/zerion-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zeriontech%2Fzerion-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31575755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T14:31:17.711Z","status":"ssl_error","status_checked_at":"2026-04-08T14:31:17.202Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-08T22:02:10.123Z","updated_at":"2026-04-08T22:02:13.516Z","avatar_url":"https://github.com/zeriontech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# zerion-ai\n\n**Maintained by Zerion.**\n\n`zerion-ai` is the public, self-contained repo for using Zerion from AI agents and developer tools.\n\nIt packages two first-class integration paths:\n\n- **Hosted MCP** for Cursor, Claude, and other MCP-native agent environments\n- **`zerion-cli`** for OpenClaw-like and command-based agent runtimes\n\nIt also ships one flagship workflow:\n\n- **`wallet-analysis`** as a reusable skill/playbook for portfolio, positions, transactions, and PnL analysis\n\n![Wallet analysis demo](./assets/demo-wallet-analysis.svg)\n\n## 1. Choose your authentication method\n\n### Option A: API Key\n\nGet an API key and export it: [Get your API key](https://dashboard.zerion.io)\n\n```bash\nexport ZERION_API_KEY=\"zk_dev_...\"\n```\n\n- API auth via **HTTP Basic Auth**\n- dev keys beginning with `zk_dev_`\n- current dev-key limits of **120 requests/minute** and **5k requests/day**\n\nUseful docs:\n\n- [Build with AI](https://developers.zerion.io/reference/building-with-ai)\n- [Get Wallet Data With Zerion API](https://developers.zerion.io/reference/getting-started)\n\n### Option B: x402 Pay-per-call\n\n**No API key needed.** Pay $0.01 USDC per request via the [x402 protocol](https://www.x402.org/). Supports EVM (Base) and Solana. The CLI handles the payment handshake automatically.\n\n**Single key** — format is auto-detected:\n\n```bash\nexport WALLET_PRIVATE_KEY=\"0x...\"    # EVM (Base) — 0x-prefixed hex\nexport WALLET_PRIVATE_KEY=\"5C1y...\"  # Solana — base58 encoded keypair\n```\n\n**Both chains simultaneously:**\n\n```bash\nexport EVM_PRIVATE_KEY=\"0x...\"\nexport SOLANA_PRIVATE_KEY=\"5C1y...\"\nexport ZERION_X402_PREFER_SOLANA=true  # optional: prefer Solana when both are set\n```\n\nThen use the `--x402` flag:\n\n```bash\nzerion-cli wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --x402\n```\n\nOr enable x402 globally:\n\n```bash\nexport ZERION_X402=true\nzerion-cli wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\n```\n\n## 2. Install skills (Claude Code, Cursor, OpenClaw)\n\n```bash\nnpx skills add zeriontech/zerion-ai\n```\n\nThis installs 3 skills into your agent:\n\n| Skill | Description |\n|-------|-------------|\n| **wallet-analysis** | Analyze wallets: portfolio, positions, transactions, PnL |\n| **chains** | List supported blockchain networks |\n| **zerion-cli** | CLI setup, authentication, and troubleshooting |\n\nThe skills reference `zerion-cli` which runs via `npx zerion-cli` (no global install needed).\n\n## 3. Choose your integration path\n\n### MCP clients\n\nUse this if your agent runtime already supports MCP.\n\nStart here:\n\n- [Hosted MCP quickstart](./mcp/README.md)\n- [Cursor example](./examples/cursor/README.md)\n- [Claude example](./examples/claude/README.md)\n\n### OpenClaw and CLI-based agents\n\nUse this if your framework models tools as shell commands returning JSON.\n\n```bash\nnpm install -g zerion-cli\nzerion-cli wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\n```\n\nStart here:\n\n- [OpenClaw example](./examples/openclaw/README.md)\n- [CLI usage](./cli/README.md)\n\n## 4. Run the first wallet analysis\n\n### MCP quickstart\n\n1. Export your API key:\n\n   ```bash\n   export ZERION_API_KEY=\"zk_dev_...\"\n   ```\n\n2. Add the hosted Zerion MCP config from [examples/cursor/mcp.json](./examples/cursor/mcp.json) or [examples/claude/mcp.json](./examples/claude/mcp.json)\n3. Ask:\n\n   ```text\n   Analyze the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.\n   Summarize total portfolio value, top positions, recent transactions, and PnL.\n   ```\n\n### CLI quickstart\n\n**With API key:**\n\n```bash\nnpm install -g zerion-cli\nexport ZERION_API_KEY=\"zk_dev_...\"\nzerion-cli wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\n```\n\n**With x402 (no API key needed):**\n\n```bash\nnpm install -g zerion-cli\nexport WALLET_PRIVATE_KEY=\"0x...\"   # or base58 for Solana\nzerion-cli wallet analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --x402\n```\n\nExample output:\n\n```json\n{\n  \"wallet\": {\n    \"query\": \"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"\n  },\n  \"portfolio\": {\n    \"total\": 450000,\n    \"currency\": \"usd\"\n  },\n  \"positions\": {\n    \"count\": 42\n  },\n  \"transactions\": {\n    \"sampled\": 10\n  },\n  \"pnl\": {\n    \"available\": true\n  }\n}\n```\n\n## Example wallets\n\nThis repo uses the same public wallets across examples:\n\n- `vitalik.eth` / `0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045`\n- ENS DAO treasury / `0xFe89Cc7Abb2C4183683Ab71653c4cCd1b9cC194e`\n- Aave collector / `0x25F2226B597E8F9514B3F68F00F494CF4F286491`\n\n## What ships in this repo\n\n- [`skills/`](./skills/): 3 agent skills installable via `npx skills add zeriontech/zerion-ai`\n  - [`wallet-analysis/`](./skills/wallet-analysis/SKILL.md): portfolio, positions, transactions, and PnL analysis\n  - [`chains/`](./skills/chains/SKILL.md): supported blockchain networks reference\n  - [`zerion-cli/`](./skills/zerion-cli/SKILL.md): CLI setup, auth, and troubleshooting\n- [`mcp/`](./mcp/README.md): hosted Zerion MCP setup plus the tool catalog\n- [`cli/`](./cli/README.md): `zerion-cli` JSON-first CLI (published to npm)\n- [`examples/`](./examples/): Cursor, Claude, OpenAI Agents SDK, raw HTTP, and OpenClaw setups\n\n## Failure modes to expect\n\nBoth the MCP and CLI surfaces should handle:\n\n- missing or invalid API key\n- invalid wallet address\n- unsupported chain filter\n- empty wallets / no positions\n- rate limits (`429`)\n- upstream timeout or temporary unavailability\n\nSee [mcp/README.md](./mcp/README.md) and [cli/README.md](./cli/README.md) for the concrete behavior used in this repo.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeriontech%2Fzerion-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzeriontech%2Fzerion-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzeriontech%2Fzerion-ai/lists"}