360 Secure SkillHub
360 安全技能中心

IEX Cloud CLI

核心功能为通过IEX Cloud API获取股票实时报价、历史行情、公司基本面、市场异动等各类市场数据，自动完成安全认证、API及传输错误处理。支持OpenClaw任务集成、本地Shell批量查询场景，输入为CLI指令或任务配置，输出标准化JSON数据，附带Shell脚本工具，支持多种安全密钥配置方式，保障调用可靠。

oscraters
oscraters
热度 57.24
最近更新 2026-05-11 17:27:40
分类：数据依赖：第三方 API / 代码执行 / 读写文件应用场景：财务 / 数据处理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add iex-cloud
Metadata
name
iex-cloud
description
Use this skill when a task needs IEX Cloud market data through the REST API (quotes, charts, fundamentals, market lists, and batch calls), including secure token handling and scriptable CLI usage.
homepage
https://github.com/oscraters/iex-cloud-skill
metadata
{"openclaw":{"skillKey":"iex-cloud","homepage":"https://github.com/oscraters/iex-cloud-skill","sourceRepository":"https://github.com/oscraters/iex-cloud-skill.git","requires":{"env":["IEX_TOKEN"],"optionalEnv":["IEX_CLOUD_TOKEN","IEX_BASE_URL"],"primaryEnv":["IEX_TOKEN"],"bins":["curl"],"optionalBins":["jq"]}}}

IEX Cloud

Overview

This skill provides an operational workflow for IEX Cloud API usage in OpenClaw tasks:

  • selecting the right endpoint for market-data requests
  • building valid authenticated requests
  • handling API and transport errors
  • running repeatable calls through a local Bash CLI

Quick Start

  1. Preferred for OpenClaw: store the token at skills.entries.iex-cloud.apiKey and back it with a SecretRef via openclaw secrets configure.
  2. For direct shell use outside OpenClaw, set export IEX_TOKEN=....
  3. Compatibility fallback: export IEX_CLOUD_TOKEN=....
  4. Read endpoint/parameter guidance in references/api_docs.md.
  5. Use scripts/iex_cloud_cli.sh for reliable calls.

Example:

scripts/iex_cloud_cli.sh quote AAPL
scripts/iex_cloud_cli.sh chart AAPL 1m
scripts/iex_cloud_cli.sh movers mostactive

Workflow

  1. Classify request type:
  • latest quote: quote
  • historical bars: chart
  • company/fundamentals: company, stats
  • market movers: movers
  • multi-symbol pulls: batch
  1. Validate required parameters before call dispatch.
  2. Execute request with token auth and timeout.
  3. Validate response class:
  • HTTP failure / transport failure
  • JSON payload containing API error fields
  • empty or malformed payload
  1. Normalize output downstream as needed.

Authentication and Safety

  • Primary token env var: IEX_TOKEN.
  • Compatibility token alias: IEX_CLOUD_TOKEN.
  • In OpenClaw, prefer skills.entries.iex-cloud.apiKey with SecretRefs over plaintext config.
  • Do not hardcode tokens in source files.
  • Do not print full token values in logs.
  • Prefer query parameter token=... when using these endpoints.
  • The CLI accepts only trusted IEX API hosts for base URL overrides and warns when a non-default trusted override is used.
  • raw calls are limited to relative IEX API paths. Do not pass full URLs.

Reliability Guidance

  • Use bounded timeouts (curl --max-time in CLI).
  • Handle non-2xx responses as hard failures.
  • Validate symbol, range, and list-type inputs early.
  • For large jobs, use batch endpoints where possible.
  • If you modify IEX_BASE_URL or pass --base-url, expect a warning so the change is visible during review.

OpenClaw Secrets Management

  • OpenClaw can inject this skill's API key from skills.entries.iex-cloud.apiKey for each agent run.
  • Secret refs are preferred over plaintext because the resolved secret wins at runtime and plaintext is ignored.
  • Recommended operator flow:
    • openclaw secrets audit --check
    • openclaw secrets configure
    • openclaw secrets audit --check
  • For direct shell usage outside OpenClaw, export IEX_TOKEN in your shell instead.

Included Files

  • scripts/iex_cloud_cli.sh: Bash CLI for common endpoints and raw calls.
  • scripts/README.md: CLI usage examples and command reference.
  • references/api_docs.md: operational endpoint reference and guardrails.

Resources