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 <API_KEY> header on all /v1/* endpoints. Pricing: This is a paid API. A Funda AI subscription is required. See funda.ai for pricing details.

Step 1: Check API Key Availability

!`echo $FUNDA_API_KEY | head -c 8 2>/dev/null && echo "...KEY_SET" || echo "KEY_NOT_SET"`

If KEY_NOT_SET, ask the user for their Funda API key. They can set it via:

export FUNDA_API_KEY="your-api-key-here"

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

Company Fundamentals

Analyst & Valuation

Options Data

Supply Chain Knowledge Graph

Social Sentiment & Alternative Data

SEC Filings & Transcripts

Calendar & Events

Economics & Macro

Other Data

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/<endpoint>?<params>" | 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:

1. Real-time quote (/v1/quotes?type=realtime&ticker=AAPL)
2. Company profile (/v1/company-details?type=profile&ticker=AAPL)
3. Key metrics TTM (/v1/financial-statements?type=key-metrics-ttm&ticker=AAPL)
4. Analyst price target (/v1/analyst?type=price-target-summary&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 details, search/screener, analyst data
• 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/filings-transcripts.md — SEC filings, earnings/podcast transcripts, research reports
• references/calendar-economics.md — Calendars (earnings, dividends, IPOs), economics, treasury, FRED
• references/other-data.md — News, market performance, funds, ESG, COT, crowdfunding, bulk data