OpenParable
Skip to content
← Back to skills

Chainbase Openapi Skill

Apps & Automation
chainbase-openapi-skill

Chainbase Openapi Skill is an Agent Skill for apps & automation published in the LeoYeAI/openclaw-master-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Operate Chainbase indexed wallet and token reads through UXC with a curated OpenAPI schema, API-key auth, and read-first guardrails.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/LeoYeAI/openclaw-master-skills/blob/HEAD/skills/chainbase-openapi-skill/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/chainbase-openapi-skill, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Chainbase Web3 API Skill

Use this skill to run Chainbase indexed data operations through uxc + OpenAPI.

Reuse the uxc skill for shared execution, auth, and error-handling guidance.

Prerequisites

  • uxc is installed and available in PATH.
  • Network access to https://api.chainbase.online.
  • Access to the curated OpenAPI schema URL:
    • https://raw.githubusercontent.com/holon-run/uxc/main/skills/chainbase-openapi-skill/references/chainbase-web3.openapi.json
  • A Chainbase API key.

Scope

This skill covers a read-first indexed data surface:

  • account native balance lookup
  • account token balances
  • account transaction history
  • token metadata
  • token holder reads
  • token price lookup
  • transaction detail lookup

This skill does not cover:

  • raw chain RPC methods
  • write or transaction submission flows
  • the broader Chainbase data product surface beyond the selected Web3 API reads

Authentication

Chainbase uses X-API-KEY header auth.

Configure one API-key credential and bind it to api.chainbase.online:

uxc auth credential set chainbase \
  --auth-type api_key \
  --api-key-header X-API-KEY \
  --secret-env CHAINBASE_API_KEY

uxc auth binding add \
  --id chainbase \
  --host api.chainbase.online \
  --scheme https \
  --credential chainbase \
  --priority 100

Validate the active mapping when auth looks wrong:

uxc auth binding match https://api.chainbase.online

Core Workflow

  1. Use the fixed link command by default:

    • command -v chainbase-openapi-cli
    • If missing, create it: uxc link chainbase-openapi-cli https://api.chainbase.online --schema-url https://raw.githubusercontent.com/holon-run/uxc/main/skills/chainbase-openapi-skill/references/chainbase-web3.openapi.json
    • chainbase-openapi-cli -h
  2. Inspect operation schema first:

    • chainbase-openapi-cli get:/v1/account/balance -h
    • chainbase-openapi-cli get:/v1/account/tokens -h
    • chainbase-openapi-cli get:/v1/token/metadata -h
  3. Prefer narrow account validation before broader reads:

    • chainbase-openapi-cli get:/v1/account/balance chain_id=1 address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045
    • chainbase-openapi-cli get:/v1/token/price chain_id=1 contract_address=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
    • chainbase-openapi-cli get:/v1/tx/detail chain_id=1 tx_hash=0x4e3f3bc239f496f59c3e4d4a4d5f10f7f0d6d9f4cd790beeb520d05f6f7d98ae
  4. Execute with key/value parameters:

    • chainbase-openapi-cli get:/v1/account/tokens chain_id=1 address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045 page=1 limit=20
    • chainbase-openapi-cli get:/v1/token/holders chain_id=1 contract_address=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 page=1 limit=20

Operation Groups

Account Reads

  • get:/v1/account/balance
  • get:/v1/account/tokens
  • get:/v1/account/txs

Token And Transaction Reads

  • get:/v1/token/metadata
  • get:/v1/token/holders
  • get:/v1/token/price
  • get:/v1/tx/detail

Guardrails

  • Keep automation on the JSON output envelope; do not use --text.
  • Parse stable fields first: ok, kind, protocol, data, error.
  • Treat this v1 skill as read-only. Do not imply RPC write methods, mempool send, or signing support.
  • Chainbase has multiple product surfaces. This skill is intentionally limited to indexed HTTP reads on https://api.chainbase.online.
  • Start with small page and limit values before building large crawls.
  • chainbase-openapi-cli <operation> ... is equivalent to uxc https://api.chainbase.online --schema-url <chainbase_openapi_schema> <operation> ....

References