Teknium
8b6beaab5f
* docs(audit): correctness pass across getting-started, reference, features, messaging, developer-guide, guides, integrations, user-guide * docs: add PR coverage for last 30d + Nous Portal weave + nav reorg + build fixes - Add docs for top user-visible PRs that shipped without docs (api-server session control, kanban features, telegram pin/edit, provider client tag, xAI retired-model migration, cron name lookup, --branch update flag, etc.) - Apply Nous Portal weave across 23 pages (tasteful one-liners on getting-started/learning-path, configuration, overview, vision, x-search, credential-pools, provider-routing, cron, codex-runtime, profiles, docker, messaging/index, multiple guides, plus FAQ + index promotion) - Reorganize sidebar: split Messaging into Popular/M365/Chinese/Other, Reference into Command/Configuration/Tools-Skills sub-categories, add orphan developer-guide pages (web-search-provider-plugin, browser-supervisor), move features from Integrations back to Features, fold lone spotify into Media & Web. - Regenerate skill stubs + catalogs (kanban-codex-lane, hermes-s6-container- supervision, web-pentest) - Fix broken anchor links (security/cron, configuration/fallback, telegram large-files, adding-platform-adapters step-by-step)
113 lines
3.5 KiB
Markdown
113 lines
3.5 KiB
Markdown
---
|
|
title: "Stocks — Stock quotes, history, search, compare, crypto via Yahoo"
|
|
sidebar_label: "Stocks"
|
|
description: "Stock quotes, history, search, compare, crypto via Yahoo"
|
|
---
|
|
|
|
{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
|
|
|
|
# Stocks
|
|
|
|
Stock quotes, history, search, compare, crypto via Yahoo.
|
|
|
|
## Skill metadata
|
|
|
|
| | |
|
|
|---|---|
|
|
| Source | Optional — install with `hermes skills install official/finance/stocks` |
|
|
| Path | `optional-skills/finance/stocks` |
|
|
| Version | `0.1.0` |
|
|
| Author | Mibay (Mibayy), Hermes Agent |
|
|
| License | MIT |
|
|
| Platforms | linux, macos, windows |
|
|
| Tags | `Stocks`, `Finance`, `Market`, `Crypto`, `Investing` |
|
|
| Related skills | [`dcf-model`](/docs/user-guide/skills/optional/finance/finance-dcf-model), [`comps-analysis`](/docs/user-guide/skills/optional/finance/finance-comps-analysis), [`lbo-model`](/docs/user-guide/skills/optional/finance/finance-lbo-model) |
|
|
|
|
## Reference: full SKILL.md
|
|
|
|
:::info
|
|
The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.
|
|
:::
|
|
|
|
# Stocks Skill
|
|
|
|
Read-only market data via Yahoo Finance. Five commands: `quote`, `search`,
|
|
`history`, `compare`, `crypto`. Python stdlib only — no API key, no pip
|
|
installs. Yahoo's endpoint is unofficial and may rate-limit or change.
|
|
|
|
## When to Use
|
|
|
|
- User asks for a current stock price (AAPL, TSLA, MSFT, ...)
|
|
- User wants to look up a ticker by company name
|
|
- User wants OHLCV history or performance over a date range
|
|
- User wants to compare several tickers side by side
|
|
- User asks for a crypto price (BTC, ETH, SOL, ...)
|
|
|
|
## Prerequisites
|
|
|
|
Python 3.8+ stdlib only. Optional: set `ALPHA_VANTAGE_KEY` to enrich
|
|
`market_cap`, `pe_ratio`, and 52-week levels when Yahoo's crumb-protected
|
|
fields come back null. Free key: https://www.alphavantage.co/support/#api-key
|
|
|
|
## How to Run
|
|
|
|
Invoke through the `terminal` tool. Once installed:
|
|
|
|
```
|
|
SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
|
|
python3 $SCRIPT quote AAPL
|
|
```
|
|
|
|
All output is JSON on stdout — pipe through `jq` if you want to slice it.
|
|
|
|
## Quick Reference
|
|
|
|
```
|
|
python3 $SCRIPT quote AAPL
|
|
python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
|
|
python3 $SCRIPT search "Tesla"
|
|
python3 $SCRIPT history NVDA --range 6mo
|
|
python3 $SCRIPT compare AAPL MSFT GOOGL
|
|
python3 $SCRIPT crypto BTC ETH SOL
|
|
```
|
|
|
|
## Commands
|
|
|
|
### `quote SYMBOL [SYMBOL2 ...]`
|
|
|
|
Current price, change, change%, volume, 52-week high/low.
|
|
|
|
### `search QUERY`
|
|
|
|
Find tickers by company name. Returns top 5: symbol, name, exchange, type.
|
|
|
|
### `history SYMBOL [--range RANGE]`
|
|
|
|
Daily OHLCV plus stats (min, max, avg, total return %). Ranges: `1mo`,
|
|
`3mo`, `6mo`, `1y`, `5y`. Default: `1mo`.
|
|
|
|
### `compare SYMBOL1 SYMBOL2 [...]`
|
|
|
|
Side-by-side: price, change%, 52-week performance.
|
|
|
|
### `crypto SYMBOL [SYMBOL2 ...]`
|
|
|
|
Crypto prices. Pass `BTC` (the script appends `-USD` automatically).
|
|
|
|
## Pitfalls
|
|
|
|
- Yahoo Finance's API is unofficial. Endpoints can change or rate-limit
|
|
without notice — if requests start failing, that's why.
|
|
- `market_cap` and `pe_ratio` may return null on `quote` when Yahoo's
|
|
crumb session isn't established. Set `ALPHA_VANTAGE_KEY` to backfill.
|
|
- Add a small delay between bulk requests to avoid rate-limiting.
|
|
- This is read-only — no order placement, no account integration.
|
|
|
|
## Verification
|
|
|
|
```
|
|
python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL
|
|
```
|
|
|
|
Returns a JSON object with `symbol: "AAPL"` and a numeric `price` field.
|