# Send TAAPI CLI to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "taapi", "name": "TAAPI CLI", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/oscraters/taapi", "canonicalUrl": "https://clawhub.ai/oscraters/taapi", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/taapi", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "agents/openai.yaml", "examples/bulk-multi-constructs.json", "examples/bulk-single-construct.json", "scripts/taapi-agent.sh", "tests/smoke-live.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "taapi", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-09T16:15:03.031Z", "expiresAt": "2026-05-16T16:15:03.031Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taapi", "contentDisposition": "attachment; filename=\"taapi-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "taapi" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/taapi" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/taapi", "downloadUrl": "https://openagent3.xyz/downloads/taapi", "agentUrl": "https://openagent3.xyz/skills/taapi/agent", "manifestUrl": "https://openagent3.xyz/skills/taapi/agent.json", "briefUrl": "https://openagent3.xyz/skills/taapi/agent.md" } } ``` ## Documentation ### Overview This skill gives Codex a reliable workflow for TAAPI.IO integrations and analysis tasks. It includes a CLI helper for low-friction, repeatable API calls from agents and scripts. Use this skill when: You need technical indicators (for example rsi, macd, adx) from TAAPI.IO. You need to evaluate one symbol quickly via GET requests. You need batch evaluations in one request using /bulk. You need multi-construct queries across symbols/timeframes/exchanges. You need deterministic shell-based tooling for agent loops. ### Workflow Decision Tree If you need one indicator for one market/timeframe, use direct. If you need many indicators in one API call, use bulk. If you need multiple symbol/timeframe constructs in one API call, use multi. If you need non-exchange candles (custom data), this skill documents API expectations but you should create a custom payload and use bulk --payload-file. ### API Facts (Checked February 27, 2026) Base host: https://api.taapi.io Direct endpoint pattern: GET /{indicator} Bulk endpoint: POST /bulk Mandatory direct params: secret, symbol, interval, and exchange for crypto (type=crypto, default). type=stocks is supported for stocks/ETFs. Common optional direct params: backtrack (max 50), results, addResultTimestamp, gaps, chart=heikinashi. Bulk and rate limit constraints: max 20 calculations per request on standard plans. Plan rate limits documented as: Free: 1 request / 15s Basic: 5 requests / 15s Pro: 30 requests / 15s Expert: 75 requests / 15s Primary docs: https://taapi.io/documentation/ https://taapi.io/documentation/integration/direct/ https://taapi.io/documentation/integration/post-rest-bulk/ https://taapi.io/documentation/multiple-constructs/ https://taapi.io/documentation/rate-limits/ https://taapi.io/indicators/ ### Security And Runtime Requirements This skill is an open-source wrapper around the commercial TAAPI.IO API. Live requests require a TAAPI.IO account secret. Set TAAPI_SECRET only in the current shell session. Prefer export TAAPI_SECRET=... over persistent/global shell files, and prefer the env var over --secret so the secret is less exposed in process listings. curl is required for all live requests. jq is only required for the multi command. direct, bulk, and CI-safe argument tests work without it. The default and audited endpoint is https://api.taapi.io. Overriding TAAPI_BASE_URL is an advanced escape hatch and should only be used deliberately. Sending requests to another host can expose your secret and request payloads to that endpoint. tests/smoke-live.sh sends real network requests with your live secret. Use a revocable secret and avoid running it outside an isolated session. ### Quick Start Use the local helper: # 1) Set secret once per session export TAAPI_SECRET="your_secret" # 2) Direct RSI query bash scripts/taapi-agent.sh direct \\ --indicator rsi \\ --exchange binance \\ --symbol BTC/USDT \\ --interval 1h # 3) Bulk query from JSON payload bash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json # 4) Multi-construct query (requires jq) bash scripts/taapi-agent.sh multi \\ --exchange binance \\ --symbols BTC/USDT,ETH/USDT \\ --intervals 15m,1h \\ --indicators rsi,supertrend # 5) Live smoke tests (requires real TAAPI_SECRET and network access) bash tests/smoke-live.sh ### direct Single indicator via GET: bash scripts/taapi-agent.sh direct \\ --indicator macd \\ --exchange binance \\ --symbol BTC/USDT \\ --interval 1h \\ --opt backtrack=1 \\ --opt addResultTimestamp=true ### bulk POST an explicit bulk payload file to /bulk: bash scripts/taapi-agent.sh bulk --payload-file examples/bulk-single-construct.json bash scripts/taapi-agent.sh bulk --payload-file examples/bulk-multi-constructs.json ### multi Build multi-construct payload from flags (for /bulk). Requires jq: bash scripts/taapi-agent.sh multi \\ --exchange binance \\ --symbols BTC/USDT,ETH/USDT \\ --intervals 15m,1h \\ --indicators rsi,supertrend ### Agentic Usage Guidelines Always pass --json in automation loops for stable machine parsing. Keep per-request calculations at <=20; split workloads deterministically. Handle 429 with bounded retries and backoff. Prefer bulk for multi-indicator evaluations on the same construct. Prefer multi for cross-symbol/timeframe batching when plan supports constructs. For stocks, include --type stocks and omit --exchange if not required by your setup. Treat TAAPI_BASE_URL overrides as a deliberate deviation from the default OpenClaw-audited path. If you must override it, use a session-scoped TAAPI_ALLOW_UNOFFICIAL_BASE_URL=1 as an explicit acknowledgement. ### scripts/taapi-agent.sh Bash CLI with: direct GET indicator calls bulk POST using payload files multi-construct payload generation retries for transient failures and 429 rate limits opt-in guardrails for unofficial base URLs optional jq formatting, with jq required only for multi ### examples/ Ready-to-run payloads: examples/bulk-single-construct.json examples/bulk-multi-constructs.json ### tests/ tests/test-cli.sh: CI-safe argument and error-path checks (no API call required). tests/smoke-live.sh: Live smoke checks using real TAAPI credentials. CI command: bash tests/test-cli.sh Live smoke command: export TAAPI_SECRET="your_secret" bash tests/smoke-live.sh ## Trust - Source: tencent - Verification: Indexed source record - Publisher: oscraters - Version: 1.0.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-09T16:15:03.031Z - Expires at: 2026-05-16T16:15:03.031Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/taapi) - [Send to Agent page](https://openagent3.xyz/skills/taapi/agent) - [JSON manifest](https://openagent3.xyz/skills/taapi/agent.json) - [Markdown brief](https://openagent3.xyz/skills/taapi/agent.md) - [Download page](https://openagent3.xyz/downloads/taapi)