# Send Alpha Vantage 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "alpha-vantage", "name": "Alpha Vantage CLI", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/oscraters/alpha-vantage", "canonicalUrl": "https://clawhub.ai/oscraters/alpha-vantage", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/alpha-vantage", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alpha-vantage", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "references/api_docs.md", "scripts/alpha_vantage_client.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "alpha-vantage", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T21:35:56.835Z", "expiresAt": "2026-05-06T21:35:56.835Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alpha-vantage", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=alpha-vantage", "contentDisposition": "attachment; filename=\"alpha-vantage-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "alpha-vantage" }, "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/alpha-vantage" }, "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/alpha-vantage", "downloadUrl": "https://openagent3.xyz/downloads/alpha-vantage", "agentUrl": "https://openagent3.xyz/skills/alpha-vantage/agent", "manifestUrl": "https://openagent3.xyz/skills/alpha-vantage/agent.json", "briefUrl": "https://openagent3.xyz/skills/alpha-vantage/agent.md" } } ``` ## Documentation ### Overview This skill provides a production-ready workflow for Alpha Vantage API usage: selecting the right endpoints, building validated requests, handling throttling/error responses, and preparing safe public/commercial deployment. ### Quick Start Set API key: export ALPHAVANTAGE_API_KEY=... For endpoint/params, read references/api_docs.md For scriptable calls with retry/backoff, use scripts/alpha_vantage_client.py For public deployment, follow the Deployment Guardrails section before release ### Workflow Classify request type: Price bars or latest price: time series functions Indicators (RSI, SMA, MACD, etc.): technical indicator functions Company info, earnings, statements: fundamentals FX/Crypto/Commodities/Macro: their dedicated function families Resolve mandatory parameters from references/api_docs.md. Build request with function=... and apikey=.... Parse response and branch for: HTTP error status Error Message Note (usually rate-limit/throttle condition) Empty/partial payload If Note/throttled, retry using exponential backoff with jitter. Normalize output to a stable schema before downstream use. ### Authentication Use ALPHAVANTAGE_API_KEY environment variable by default. Never hardcode keys in source, logs, prompts, or examples. Mask keys in debug output (show only short prefix/suffix). ### Reliability and Rate Limits Treat responses containing Note as retriable throttle events. Use bounded retries with exponential backoff and jitter. For multi-symbol jobs, queue calls and pace to plan limits. Cache stable responses (fundamentals, metadata) to reduce quota burn. ### Response Validation Validate both transport and payload success. Handle string-encoded numbers safely (float(...)/Decimal as needed). Keep parser logic resilient to minor schema/key ordering changes. ### Data Quality Preserve source timestamps/time zones from payload metadata. Do not infer adjusted/unadjusted semantics; use explicit functions. Record the function and params used for reproducibility/auditability. ### Public/Commercial Readiness Review Alpha Vantage terms before public/commercial release: https://www.alphavantage.co/terms_of_service/ Ensure your usage tier and traffic profile are aligned with your plan: https://www.alphavantage.co/premium/ Do not redistribute restricted content if terms disallow it. ### Security and Operations Store API keys in secret managers (or environment variables for local dev only). Add circuit-breaking and queue backpressure for upstream rate spikes. Instrument call counts, throttle rate, retry count, and error classes. Add alerting for sustained Note responses and non-2xx response spikes. ### references/ references/api_docs.md contains endpoint selection guidance and required parameters. ### scripts/ scripts/alpha_vantage_client.py provides a reusable request wrapper with: env-based auth timeout and retry logic throttle/error detection optional compact output ## Trust - Source: tencent - Verification: Indexed source record - Publisher: oscraters - Version: 1.0.0 ## 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-04-29T21:35:56.835Z - Expires at: 2026-05-06T21:35:56.835Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/alpha-vantage) - [Send to Agent page](https://openagent3.xyz/skills/alpha-vantage/agent) - [JSON manifest](https://openagent3.xyz/skills/alpha-vantage/agent.json) - [Markdown brief](https://openagent3.xyz/skills/alpha-vantage/agent.md) - [Download page](https://openagent3.xyz/downloads/alpha-vantage)