EVA Tick CLI

Deterministic, machine-readable financial data for AI agents, LLMs, and automation.

EVA Tick gives agents canonical instrument IDs, stable JSON, structured errors, and predictable commands instead of provider-specific identifiers and functions.

Install

npm install --global @evatick/cli
eva version

Run it without installing:

npx @evatick/cli health

The npm package is implemented in Node.js, has no runtime dependencies, and does not require Python or platform-specific native executables.

First query

eva health
eva instrument search --query 平安银行 --type equity --limit 3
eva instrument resolve --query 000001 --type equity
eva stock bars --symbol cn:equity:XSHE:000001 \
  --interval 1d \
  --start 2026-08-18 \
  --end 2026-08-21 \
  --limit 3

Common commands

• eva instrument search finds canonical financial instruments by name, code, or alias.
• eva stock bars queries normalized OHLCV bars with forward adjustment by default; pass --adjustment none for raw prices.
• eva index constituents queries index constituent memberships.
• eva futures bars queries domestic futures and international commodity reference/continuous daily bars.
• eva crypto quotes queries one explicitly selected cryptocurrency exchange.
• eva local-data list shows instruments already stored in the server's local warehouse.

Run eva COMMAND --help or eva GROUP COMMAND --help for supported options.

Hosted or self-hosted

The CLI connects to the hosted EVA Tick service at https://api.evatick.com by default. Point it at a self-hosted EVA Tick Server temporarily with an environment variable:

EVA_SERVER_URL=http://127.0.0.1:8765 eva health

Or save the service URL:

eva config set --base-url http://127.0.0.1:8765
eva config show

When a service requires authentication, use EVA_API_KEY or eva config set --api-key 'eva_...'. The CLI sends a key only when configured, and eva config show masks stored keys.

Current availability

EVA Tick is designed as a provider-independent financial data layer. The current public service covers mainland China A-shares; SSE, SZSE, and CSI indices; CFFEX, SHFE, INE, CZCE, DCE, and GFEX domestic futures; international gold, silver, and crude-oil daily reference/continuous series; and exchange-scoped Binance and Coinbase cryptocurrency markets. Availability varies by deployed service and enabled providers.

Output and safety

• Successful results are compact JSON on stdout.
• Failures are structured JSON on stderr with stable error codes.
• JSON, JSONL, and CSV file exports are supported by the npm CLI.
• Existing files are never overwritten unless --overwrite is explicit.
• Parquet export is available in the Python distribution with pip install 'evatick[parquet]'.

Documentation

• Complete CLI documentation and examples
• EVA Tick Skill for Codex
• Self-hosted server and OpenAPI contract
• License and data-source notices

Market data is provided for research and reference only and does not constitute investment advice.