Contains Shell Commands
This skill contains shell command directives (
!command
) that may execute system commands. Review carefully before installing.
Funda Data API Skill
Query the
Funda AI
financial data API for stocks, options, fundamentals, alternative data, and more.
Base URL:
https://api.funda.ai/v1
Auth:
Authorization: Bearer if [ -n "$FUNDA_API_KEY" ]; then echo "KEY_FROM_ENV_VAR"; elif [ -f .env ] && grep -qE "^FUNDA_API_KEY=" .env; then echo "KEY_FROM_LOCAL_DOTENV:$(pwd)/.env"; else GIT_COMMON=$(git rev-parse --path-format=absolute --git-common-dir 2>/dev/null); if [ -n "$GIT_COMMON" ]; then ROOT=$(dirname "$GIT_COMMON"); if [ -f "$ROOT/.env" ] && grep -qE "^FUNDA_API_KEY=" "$ROOT/.env"; then echo "KEY_FROM_ROOT_DOTENV:$ROOT/.env"; else echo "KEY_NOT_SET"; fi; else echo "KEY_NOT_SET"; fi; fi
Then act on the result:
KEY_FROM_ENV_VAR
— use
$FUNDA_API_KEY
directly in curl calls.
KEY_FROM_LOCAL_DOTENV:
| head -1 | cut -d = -f2- | sed 's/^["' \ ' ']//;s/["' \ ' ']$//' ) Substitute the path printed by the check above. Prefer sourcing once at the start of a session rather than re-exporting on every call. KEY_NOT_SET — ask the user for their Funda API key. They can either: export FUNDA_API_KEY = "your-api-key-here" or add FUNDA_API_KEY=your-api-key-here to .env at the repo root (preferred when working across worktrees). Once the key is available, proceed. All curl commands below use $FUNDA_API_KEY . Step 2: Identify What the User Needs Match the user's request to a data category below, then read the corresponding reference file for full endpoint details, parameters, and response schemas. Market Data & Prices User Request Endpoint Reference Real-time quote, current price GET /v1/quotes?type=realtime&ticker=X references/market-data.md Batch quotes for multiple tickers GET /v1/quotes?type=batch&ticker=X,Y,Z references/market-data.md After-hours / aftermarket quote GET /v1/quotes?type=aftermarket-quote&ticker=X references/market-data.md Historical EOD prices GET /v1/stock-price?ticker=X&date_after=...&date_before=... references/market-data.md Intraday candles (1min–4hr) GET /v1/charts?type=5min&ticker=X references/market-data.md Technical indicators (SMA, EMA, RSI, ADX) GET /v1/charts?type=sma&ticker=X&period_length=50 references/market-data.md Commodity / forex / crypto quotes GET /v1/quotes?type=commodity-quotes references/market-data.md Company Fundamentals User Request Endpoint Reference Income statement GET /v1/financial-statements?type=income-statement&ticker=X references/fundamentals.md Balance sheet GET /v1/financial-statements?type=balance-sheet&ticker=X references/fundamentals.md Cash flow statement GET /v1/financial-statements?type=cash-flow&ticker=X references/fundamentals.md Key metrics (P/E, ROE, etc.) GET /v1/financial-statements?type=key-metrics&ticker=X references/fundamentals.md Financial ratios GET /v1/financial-statements?type=ratios&ticker=X references/fundamentals.md Revenue segmentation (product/geo) GET /v1/financial-statements?type=revenue-product-segmentation&ticker=X references/fundamentals.md Quick company profile (price, mcap, sector) GET /v1/company-profile?ticker=X references/fundamentals.md Company profile, executives, market cap, M&A GET /v1/company-details?type=profile&ticker=X references/fundamentals.md Peers / competitors list GET /v1/company-details?type=peers&ticker=X references/fundamentals.md Shares float / historical market cap GET /v1/company-details?type=shares-float&ticker=X references/fundamentals.md Company search by symbol/name GET /v1/search?type=symbol&query=X references/fundamentals.md Stock screener (market cap, sector, etc.) GET /v1/search?type=screener&marketCapMoreThan=... references/fundamentals.md List companies (pagination) GET /v1/companies references/fundamentals.md Analyst & Valuation User Request Endpoint Reference Analyst estimates (EPS, revenue) GET /v1/analyst?type=estimates&ticker=X references/fundamentals.md Price targets GET /v1/analyst?type=price-target-summary&ticker=X references/fundamentals.md Analyst grades (buy/hold/sell) GET /v1/analyst?type=grades&ticker=X references/fundamentals.md Grades consensus / historical GET /v1/analyst?type=grades-consensus&ticker=X references/fundamentals.md DCF / levered / custom DCF GET /v1/analyst?type=dcf&ticker=X references/fundamentals.md Ratings snapshot / historical GET /v1/analyst?type=ratings-snapshot&ticker=X references/fundamentals.md Earnings surprises (bulk) GET /v1/bulk?type=earnings-surprises references/other-data.md Options Data User Request Endpoint Reference Option chains GET /v1/options/stock?ticker=X&type=option-chains references/options.md Option contracts (volume, OI, premium) GET /v1/options/stock?ticker=X&type=option-contracts references/options.md Greeks per strike/expiry GET /v1/options/stock?ticker=X&type=greeks&expiry=... references/options.md GEX / gamma exposure GET /v1/options/stock?ticker=X&type=greek-exposure references/options.md Spot GEX (per-minute) GET /v1/options/stock?ticker=X&type=spot-gex references/options.md IV rank, IV term structure GET /v1/options/stock?ticker=X&type=iv-rank references/options.md Max pain GET /v1/options/stock?ticker=X&type=max-pain references/options.md Options flow / recent trades GET /v1/options/stock?ticker=X&type=flow-recent references/options.md Unusual options activity (flow alerts) GET /v1/options/flow-alerts?is_sweep=true&min_premium=100000 references/options.md Options screener (hottest chains) GET /v1/options/screener?min_volume=1000 references/options.md Contract-level flow/history GET /v1/options/contract?contract_id=X&type=flow references/options.md Net premium ticks GET /v1/options/stock?ticker=X&type=net-prem-ticks references/options.md OI change GET /v1/options/stock?ticker=X&type=oi-change references/options.md NOPE indicator GET /v1/options/stock?ticker=X&type=nope references/options.md Supply Chain Knowledge Graph User Request Endpoint Reference Supply chain stocks GET /v1/supply-chain/stocks?ticker=X references/supply-chain.md Bottleneck stocks GET /v1/supply-chain/stocks/bottlenecks references/supply-chain.md Upstream suppliers GET /v1/supply-chain/kg-edges/graph/suppliers/X?depth=2 references/supply-chain.md Downstream customers GET /v1/supply-chain/kg-edges/graph/customers/X?depth=2 references/supply-chain.md Competitors GET /v1/supply-chain/kg-edges/graph/competitors/X references/supply-chain.md Partners GET /v1/supply-chain/kg-edges/graph/partners/X references/supply-chain.md All neighbors (1-hop) GET /v1/supply-chain/kg-edges/graph/neighbors/X references/supply-chain.md KG edges (relationships) GET /v1/supply-chain/kg-edges?source_ticker=X references/supply-chain.md Social Sentiment & Alternative Data User Request Endpoint Reference Financial Twitter/KOL tweets GET /v1/twitter-posts?ticker=X references/alternative-data.md Single tweet by ID GET /v1/twitter-posts/{twitter_post_id} references/alternative-data.md Reddit posts (wallstreetbets, etc.) GET /v1/reddit-posts?subreddit=wallstreetbets&ticker=X references/alternative-data.md Reddit comments GET /v1/reddit-comments?ticker=X references/alternative-data.md Polymarket prediction markets GET /v1/polymarket/markets?keyword=bitcoin references/alternative-data.md Polymarket events GET /v1/polymarket/events?keyword=election references/alternative-data.md Congressional/government trades GET /v1/government-trading?type=senate-latest references/alternative-data.md Insider trades (Form 4) GET /v1/ownership?type=insider-search&ticker=X references/alternative-data.md Institutional holdings (13F) GET /v1/ownership?type=institutional-latest&ticker=X references/alternative-data.md AI-Enriched News User Request Endpoint Reference AI-enriched news for a ticker (summary + sentiment) GET /v1/news/ticker?ticker=X references/news-enriched.md Event timeline for a ticker (developing stories) GET /v1/news/timeline?ticker=X references/news-enriched.md Aggregated ticker sentiment (7–90d lookback) GET /v1/news/sentiment?ticker=X&days=7 references/news-enriched.md SEC Filings & Transcripts User Request Endpoint Reference SEC filings (10-K, 10-Q, 8-K) GET /v1/sec-filings?ticker=X&form_type=10-K references/filings-transcripts.md Search SEC filings GET /v1/sec-filings-search?type=8-K&ticker=X references/filings-transcripts.md Earnings call transcripts GET /v1/transcripts?ticker=X&type=earning_call references/filings-transcripts.md Podcast transcripts GET /v1/transcripts?type=podcast references/filings-transcripts.md Investment research reports GET /v1/investment-research-reports?ticker=X references/filings-transcripts.md Calendar & Events User Request Endpoint Reference Upcoming earnings GET /v1/calendar?type=earnings-calendar&date_after=... references/calendar-economics.md Dividend calendar GET /v1/calendar?type=dividends-calendar&date_after=... references/calendar-economics.md IPO calendar GET /v1/calendar?type=ipos-calendar references/calendar-economics.md Stock splits GET /v1/calendar?type=splits-calendar references/calendar-economics.md Economic calendar GET /v1/calendar?type=economic-calendar references/calendar-economics.md Economics & Macro User Request Endpoint Reference Treasury rates GET /v1/economics?type=treasury-rates references/calendar-economics.md GDP, CPI, unemployment, etc. GET /v1/economics?type=indicators&indicator=GDP references/calendar-economics.md FRED series data GET /v1/fred?type=... references/calendar-economics.md Market risk premium GET /v1/economics?type=market-risk-premium references/calendar-economics.md Other Data User Request Endpoint Reference News (stock, crypto, forex) GET /v1/news?type=stock&ticker=X references/other-data.md Press releases GET /v1/news?type=press-releases&ticker=X references/other-data.md Stock news (simple) GET /v1/stock-news?ticker=X references/other-data.md Market performance (gainers/losers) GET /v1/market-performance?type=gainers references/other-data.md ETF/fund holdings GET /v1/funds?type=etf-holdings&ticker=X references/other-data.md ESG ratings GET /v1/esg?type=ratings&ticker=X references/other-data.md COT reports GET /v1/cot-report?type=... references/other-data.md Crowdfunding GET /v1/crowdfunding?type=... references/other-data.md Market hours GET /v1/market-hours?type=... references/other-data.md Bulk data downloads GET /v1/bulk?type=... references/other-data.md AI Company Recruit Signals Hiring-based alpha signals covering OpenAI, Anthropic, Google, xAI, SurgeAI, and Mercor. User Request Endpoint Reference AI company job postings (raw) GET /v1/recruit-job-postings?company=anthropic references/recruit.md JD classifications (vertical/intent/function) GET /v1/recruit-jd-classifications?company=openai&vertical=Coding references/recruit.md Product-level hiring signal clusters GET /v1/recruit-product-signal-clusters?urgency=high references/recruit.md GTM products extracted from Sales JDs GET /v1/recruit-gtm-products?company=openai references/recruit.md Product launch probability matrix GET /v1/recruit-launch-probabilities?company=anthropic references/recruit.md Public stock impact scores (AI threat) GET /v1/recruit-stock-impacts?urgency=HIGH references/recruit.md Enterprise events + event-study alpha GET /v1/recruit-enterprise-events?is_significant=true references/recruit.md Claude API Proxy User Request Endpoint Reference Proxy Claude API call via Bedrock (streaming supported) POST /v1/claude/v1/messages references/claude-proxy.md Step 3: Make the API Call Use curl with the bearer token to call the Funda API. Read the appropriate reference file first for exact parameter names and response formats. Template: curl -s -H "Authorization: Bearer $FUNDA_API_KEY " \ "https://api.funda.ai/v1/
? " | python3 -m json.tool Response format: All endpoints return {"code": "0", "message": "", "data": ...} . Check that code is "0" — non-zero means an error occurred (the message field explains why). Pagination: List endpoints return {"items": [...], "page": 0, "page_size": 20, "next_page": 1, "total_count": N} . Pages are 0-based. next_page is -1 when there are no more pages. Step 4: Handle Common Patterns Multiple data points for one ticker If the user asks a broad question like "tell me about AAPL", combine several calls: Company profile ( /v1/company-profile?ticker=AAPL ) — includes price, market cap, sector, CEO, description in one call Key metrics TTM ( /v1/financial-statements?type=key-metrics-ttm&ticker=AAPL ) Analyst price target ( /v1/analyst?type=price-target-summary&ticker=AAPL ) Optional: latest AI-enriched news ( /v1/news/ticker?ticker=AAPL&page_size=5 ) and aggregated sentiment ( /v1/news/sentiment?ticker=AAPL ) Comparing multiple tickers Use batch quotes for prices, then individual calls for fundamentals. The batch endpoint accepts comma-separated tickers: /v1/quotes?type=batch&ticker=AAPL,MSFT,GOOGL . Ticker lookup If the user provides a company name instead of a ticker, search first: GET /v1/search?type=name&query=nvidia Step 5: Respond to the User Present the data clearly: Format numbers with appropriate precision (prices to 2 decimals, ratios to 2-4 decimals, large numbers with commas or abbreviations like $2.8T) Use tables for comparative data Highlight key insights (e.g., "Trading above/below analyst target", "Earnings beat/miss") For time series data, summarize the trend rather than dumping raw numbers Always note the data source: "Data from Funda AI API" Never provide trading recommendations — present the data and let the user draw conclusions Reference Files references/market-data.md — Quotes, historical prices, charts, technical indicators references/fundamentals.md — Financial statements, company profile/details, search/screener, analyst data, companies list references/options.md — Options chains, greeks, GEX, flow, IV, screener, contract-level data references/supply-chain.md — Supply chain knowledge graph, relationships, graph traversal references/alternative-data.md — Twitter, Reddit, Polymarket, government trading, ownership references/news-enriched.md — AI-enriched news (summary/sentiment), event timeline, aggregated ticker sentiment references/filings-transcripts.md — SEC filings, earnings/podcast transcripts, research reports, emails references/calendar-economics.md — Calendars (earnings, dividends, IPOs), economics, treasury, FRED references/recruit.md — AI-company job postings, JD classifications, product clusters, GTM products, launch probabilities, stock impacts, enterprise events references/other-data.md — News, market performance, funds, ESG, COT, crowdfunding, bulk data, market hours, stock news references/claude-proxy.md — Claude API proxy ( /v1/claude/v1/messages )