name: stonks
description: Check stock and crypto prices using free APIs (no key required).
homepage: https://query1.finance.yahoo.com
metadata: {"openclaw":{"emoji":"📈","requires":{"bins":["curl","jq"]}}}

Stonks

Quick price checks for stocks and crypto. No API keys needed.

Stocks (Yahoo Finance)

Current Price

# Get current price for a stock
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/AAPL?interval=1d&range=1d" | \
  jq '{symbol: .chart.result[0].meta.symbol, price: .chart.result[0].meta.regularMarketPrice, currency: .chart.result[0].meta.currency}'

Multiple Stocks

# Check multiple at once
for ticker in AAPL GOOGL MSFT; do
  price=$(curl -s "https://query1.finance.yahoo.com/v8/finance/chart/$ticker?interval=1d&range=1d" | jq -r '.chart.result[0].meta.regularMarketPrice')
  echo "$ticker: \$$price"
done

Price History

# Last 5 days
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/AAPL?interval=1d&range=5d" | \
  jq '.chart.result[0].indicators.quote[0].close'

Crypto (CoinGecko)

Current Price

# Bitcoin price
curl -s "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" | jq '.bitcoin.usd'

# Multiple coins
curl -s "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin,ethereum,solana&vs_currencies=usd" | jq .

With 24h Change

curl -s "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd&include_24hr_change=true" | jq .

Top Coins

curl -s "https://api.coingecko.com/api/v3/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=10" | \
  jq '.[] | {name, symbol, price: .current_price, change_24h: .price_change_percentage_24h}'

Quick One-Liners

# Apple stock price
curl -s "https://query1.finance.yahoo.com/v8/finance/chart/AAPL" | jq -r '.chart.result[0].meta.regularMarketPrice'

# Bitcoin in USD
curl -s "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" | jq -r '.bitcoin.usd'

# Ethereum in USD
curl -s "https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd" | jq -r '.ethereum.usd'

Rate Limits

• Yahoo Finance: ~2000 requests/hour (unofficial, be respectful)
• CoinGecko: 10-30 requests/minute (free tier)

Coin IDs

For CoinGecko, use coin IDs not symbols:
- Bitcoin: bitcoin
- Ethereum: ethereum
- Solana: solana
- Dogecoin: dogecoin

Find IDs: curl -s "https://api.coingecko.com/api/v3/search?query=YOUR_COIN" | jq '.coins[0].id'