Agent skill

Finance Data

by Bitterbot-AI in Bitterbot-AI/bitterbot-desktop

Get stock quotes, company info, market data, and crypto prices.

MITAuto-check passedBusiness, Finance & HR

Install Finance Data

skills CLI
$ npx skills add Bitterbot-AI/bitterbot-desktop --skill finance-data -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Bitterbot-AI/bitterbot-desktop finance-data --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Bitterbot-AI/bitterbot-desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/finance-data .claude/skills/finance-data && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
finance-data
GitHub stars
2.5k
Token cost
~696 tokens
SKILL.md length
186 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

Get stock quotes, company info, market data, and crypto prices.

  • Tasks that involve Stock and market analysis
  • SKILL.md covers Stock Quote (current price +…, Company Profile & Financials, Market Movers and Multi-Quote (batch), plus 4 more sections
  • Calls curl; reaches query1.finance.yahoo.com

What it does

Finance Data is an agent skill from Bitterbot-AI/bitterbot-desktop. Get stock quotes, company info, market data, and crypto prices. No API key needed.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Stock and market analysis. The repository describes itself as: Bitterbot - a mesh of agents that turns shared experience into collective capability. The licence is MIT.

When your agent uses it

  • Tasks that involve Stock and market analysis

Example prompts

  • “/finance-data”

What it can do on your machine

Read from SKILL.md and the folder at commit 5e5a9e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • query1.finance.yahoo.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Finance Data loads about 696 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~696

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Bitterbot-AI/bitterbot-desktop at commit 5e5a9e4, republished under its MIT licence (© Bitterbot-AI). 186 words, ~696 tokens.

Download SKILL.mdSave it as .claude/skills/finance-data/SKILL.md (or your agent's skills folder).
name
finance-data
description
Get stock quotes, company info, market data, and crypto prices. No API key needed.

Finance Data

Real-time and historical financial data via Yahoo Finance (free, no API key).

Stock Quote (current price + 5-day chart)

bash
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/AAPL?interval=1d&range=5d" \
  -H "User-Agent: Mozilla/5.0"

Replace AAPL with any ticker symbol. Response is JSON:

  • chart.result[0].meta.regularMarketPrice — current price
  • chart.result[0].meta.previousClose — previous close
  • chart.result[0].meta.currency — currency
  • chart.result[0].indicators.quote[0].close — closing prices array

Company Profile & Financials

bash
curl -s "https://query1.finance.yahoo.com/v10/finance/quoteSummary/AAPL?modules=assetProfile,financialData,defaultKeyStatistics" \
  -H "User-Agent: Mozilla/5.0"

Useful modules (comma-separated):

  • assetProfile — sector, industry, employees, description
  • financialData — revenue, margins, EPS, recommendation
  • defaultKeyStatistics — P/E, market cap, beta, float
  • incomeStatementHistory — income statements
  • balanceSheetHistory — balance sheet
  • cashflowStatementHistory — cash flows

Market Movers

bash
curl -s "https://query1.finance.yahoo.com/v1/finance/trending/US" \
  -H "User-Agent: Mozilla/5.0"

Multi-Quote (batch)

bash
curl -s "https://query1.finance.yahoo.com/v7/finance/quote?symbols=AAPL,GOOGL,MSFT" \
  -H "User-Agent: Mozilla/5.0"

Returns an array under quoteResponse.result[] with price, change, volume, marketCap for each symbol.

Historical Data (longer range)

bash
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/AAPL?interval=1wk&range=1y" \
  -H "User-Agent: Mozilla/5.0"

Interval options: 1m, 5m, 15m, 1d, 1wk, 1mo Range options: 1d, 5d, 1mo, 3mo, 6mo, 1y, 5y, max

Crypto

Same API, use crypto ticker format:

bash
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/BTC-USD?interval=1d&range=5d" \
  -H "User-Agent: Mozilla/5.0"

Common crypto tickers: BTC-USD, ETH-USD, SOL-USD, DOGE-USD

Forex

bash
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/EURUSD=X?interval=1d&range=1mo" \
  -H "User-Agent: Mozilla/5.0"

Format: {FROM}{TO}=X (e.g., GBPUSD=X, USDJPY=X)

Response Parsing Tips

  • All responses are JSON. Use exec to run curl and parse with JSON.parse().
  • Always include the User-Agent header to avoid 403 errors.
  • Yahoo Finance rate limits are generous for individual use.
  • If a quote endpoint returns empty, try the chart endpoint instead.
  • For crypto and forex, always include =X or -USD suffix.

© Bitterbot-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/finance-data of Bitterbot-AI/bitterbot-desktop.

Open the folder on GitHubat commit 5e5a9e4

Compare with similar skills

Finance Data next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Finance Data compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Finance Data this skillBitterbot-AI/bitterbot-desktop2.5k—~696Automated safety check: PassMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Tushare Datazillionare/zillionare3182 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp4.9k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle867—~5.9kAutomated safety check: PassMIT
Longbridge Researchhelsome/folio2693 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    318 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    4.9k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    867 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    269 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed
  • Longbridge Earnings

    helsome/folio

    Earnings analysis — pre- and post-earnings. An agent skill from helsome/folio.

    269 GitHub starsUsed in 1 repo~2.5k tokens
    Business, Finance & HRAuto-check passed

More from Bitterbot-AI/bitterbot-desktop

All 17 skills in this repo
  • Canvas

    Bitterbot-AI/bitterbot-desktop

    Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server.

    2.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Moltbook

    Bitterbot-AI/bitterbot-desktop

    Participate in Moltbook — the social network for AI agents. An agent skill from Bitterbot-AI/bitterbot-desktop.

    2.5k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Pre Action Interceptors

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when a tool error begins with "INTERCEPTOR:", a sent message was silently hedged or rewritten, or the user asks about active guards or blocked actions.

    2.5k GitHub stars~580 tokensUpdated today
    Auto-check passed
  • Forage Economy

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when anyone asks about bounties (or "forge"), agent earnings, the agent economy, marketplace skills, A2A activity or your network reputation.

    2.5k GitHub stars~633 tokensUpdated today
    Auto-check passed
  • Memory Architecture

    Bitterbot-AI/bitterbot-desktop

    A skill your agent uses when the user asks how your memory, dreams, hormones or knowledge crystals work, or when you need to interpret memorystatus output.

    2.5k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Notte

    Bitterbot-AI/bitterbot-desktop

    Deploy browser automations as scheduled, API-callable serverless Functions — plus stealth sessions, vault-backed login, captcha solving, and natural-language agent runs via the Notte CLI.

    2.5k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Finance Data

What does Finance Data do?

Get stock quotes, company info, market data, and crypto prices. Finance Data is an agent skill from Bitterbot-AI/bitterbot-desktop. Get stock quotes, company info, market data, and crypto prices.

When should I use Finance Data?

Finance Data fits situations like: tasks that involve Stock and market analysis.

How do I install Finance Data in Claude Code?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill finance-data -a claude-code`. Or copy the skill folder (skills/finance-data in Bitterbot-AI/bitterbot-desktop) into .claude/skills/finance-data in your project. Claude Code loads it when a task matches its description.

How do I install Finance Data in Codex?

Run `npx skills add Bitterbot-AI/bitterbot-desktop --skill finance-data -a codex`. Or copy the skill folder (skills/finance-data in Bitterbot-AI/bitterbot-desktop) into .agents/skills/finance-data in your project. Codex loads it when a task matches its description.

Can I use Finance Data in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Bitterbot-AI/bitterbot-desktop --skill finance-data -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/finance-data, .gemini/skills/finance-data, .github/skills/finance-data and .opencode/skills/finance-data in your project.

What does Finance Data need to run?

Going by SKILL.md and its folder, Finance Data needs the command-line tools its instructions call (curl).

Does Finance Data access the network?

SKILL.md names 1 domain. In commands or code: query1.finance.yahoo.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Finance Data safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Finance Data use?

Finance Data is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Finance Data use?

About 696 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Finance Data?

Skills that share tags, products or a category with Finance Data: Stock API (zhangxiangliang/stock-api, 2k stars), Tushare Data (zillionare/zillionare, 318 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 4.9k stars) and Digital Oracle (komako-workshop/digital-oracle, 867 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Finance Data?

Bitterbot-AI (a GitHub organization) maintains it in Bitterbot-AI/bitterbot-desktop, which has 2,464 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

Source: Bitterbot-AI/bitterbot-desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.