funda-data

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Funda Data API Skill

Funda Data API 技能

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.

查询Funda AI金融数据API,获取股票、期权、基本面、另类数据等信息。
基础URL:
https://api.funda.ai/v1
鉴权方式: 所有
/v1/*
端点请求头需携带
Authorization: Bearer <API_KEY>
定价说明: 这是付费API,需要订阅Funda AI服务。访问funda.ai查看定价详情。

Step 1: Check API Key Availability

步骤1:检查API密钥是否可用

!`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:
bash
export FUNDA_API_KEY="your-api-key-here"
Once the key is available, proceed. All
curl
commands below use
$FUNDA_API_KEY
.

!`echo $FUNDA_API_KEY | head -c 8 2>/dev/null && echo "...KEY_SET" || echo "KEY_NOT_SET"`
如果返回
KEY_NOT_SET
,请向用户索要Funda API密钥,用户可通过以下命令设置:
bash
export FUNDA_API_KEY="your-api-key-here"
确认密钥可用后继续后续操作,以下所有
curl
命令都会使用
$FUNDA_API_KEY
变量。

Step 2: Identify What the User Needs

步骤2:识别用户需求

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 RequestEndpointReference
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
用户需求Endpoint参考文档
实时报价、当前价格
GET /v1/quotes?type=realtime&ticker=X
references/market-data.md
多股票批量报价
GET /v1/quotes?type=batch&ticker=X,Y,Z
references/market-data.md
盘后报价
GET /v1/quotes?type=aftermarket-quote&ticker=X
references/market-data.md
历史日终价格
GET /v1/stock-price?ticker=X&date_after=...&date_before=...
references/market-data.md
日内K线(1分钟-4小时)
GET /v1/charts?type=5min&ticker=X
references/market-data.md
技术指标(SMA、EMA、RSI、ADX)
GET /v1/charts?type=sma&ticker=X&period_length=50
references/market-data.md
大宗商品/外汇/加密货币报价
GET /v1/quotes?type=commodity-quotes
references/market-data.md

Company Fundamentals

公司基本面

User RequestEndpointReference
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
Company profile, executives, market cap
GET /v1/company-details?type=profile&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
用户需求Endpoint参考文档
利润表
GET /v1/financial-statements?type=income-statement&ticker=X
references/fundamentals.md
资产负债表
GET /v1/financial-statements?type=balance-sheet&ticker=X
references/fundamentals.md
现金流量表
GET /v1/financial-statements?type=cash-flow&ticker=X
references/fundamentals.md
核心指标(市盈率、净资产收益率等)
GET /v1/financial-statements?type=key-metrics&ticker=X
references/fundamentals.md
财务比率
GET /v1/financial-statements?type=ratios&ticker=X
references/fundamentals.md
收入拆分(产品/地域)
GET /v1/financial-statements?type=revenue-product-segmentation&ticker=X
references/fundamentals.md
公司简介、高管信息、市值
GET /v1/company-details?type=profile&ticker=X
references/fundamentals.md
按代码/名称搜索公司
GET /v1/search?type=symbol&query=X
references/fundamentals.md
股票筛选(市值、板块等维度)
GET /v1/search?type=screener&marketCapMoreThan=...
references/fundamentals.md

Analyst & Valuation

分析师与估值

User RequestEndpointReference
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
DCF valuation
GET /v1/analyst?type=dcf&ticker=X
references/fundamentals.md
Ratings snapshot
GET /v1/analyst?type=ratings-snapshot&ticker=X
references/fundamentals.md
用户需求Endpoint参考文档
分析师预期(每股收益、营收)
GET /v1/analyst?type=estimates&ticker=X
references/fundamentals.md
目标价
GET /v1/analyst?type=price-target-summary&ticker=X
references/fundamentals.md
分析师评级(买入/持有/卖出)
GET /v1/analyst?type=grades&ticker=X
references/fundamentals.md
DCF估值
GET /v1/analyst?type=dcf&ticker=X
references/fundamentals.md
评级快照
GET /v1/analyst?type=ratings-snapshot&ticker=X
references/fundamentals.md

Options Data

期权数据

User RequestEndpointReference
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
用户需求Endpoint参考文档
期权链
GET /v1/options/stock?ticker=X&type=option-chains
references/options.md
期权合约(成交量、未平仓合约、权利金)
GET /v1/options/stock?ticker=X&type=option-contracts
references/options.md
不同行权价/到期日的Greeks值
GET /v1/options/stock?ticker=X&type=greeks&expiry=...
references/options.md
GEX / 伽马敞口
GET /v1/options/stock?ticker=X&type=greek-exposure
references/options.md
实时GEX(分钟级更新)
GET /v1/options/stock?ticker=X&type=spot-gex
references/options.md
IV排名、IV期限结构
GET /v1/options/stock?ticker=X&type=iv-rank
references/options.md
最大痛点
GET /v1/options/stock?ticker=X&type=max-pain
references/options.md
期权流 / 近期交易
GET /v1/options/stock?ticker=X&type=flow-recent
references/options.md
异常期权交易(流预警)
GET /v1/options/flow-alerts?is_sweep=true&min_premium=100000
references/options.md
期权筛选(热门期权链)
GET /v1/options/screener?min_volume=1000
references/options.md
合约级流/历史数据
GET /v1/options/contract?contract_id=X&type=flow
references/options.md
净权利金变动
GET /v1/options/stock?ticker=X&type=net-prem-ticks
references/options.md
未平仓合约变动
GET /v1/options/stock?ticker=X&type=oi-change
references/options.md
NOPE指标
GET /v1/options/stock?ticker=X&type=nope
references/options.md

Supply Chain Knowledge Graph

供应链知识图谱

User RequestEndpointReference
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
用户需求Endpoint参考文档
供应链相关股票
GET /v1/supply-chain/stocks?ticker=X
references/supply-chain.md
瓶颈节点股票
GET /v1/supply-chain/stocks/bottlenecks
references/supply-chain.md
上游供应商
GET /v1/supply-chain/kg-edges/graph/suppliers/X?depth=2
references/supply-chain.md
下游客户
GET /v1/supply-chain/kg-edges/graph/customers/X?depth=2
references/supply-chain.md
竞争对手
GET /v1/supply-chain/kg-edges/graph/competitors/X
references/supply-chain.md
合作伙伴
GET /v1/supply-chain/kg-edges/graph/partners/X
references/supply-chain.md
所有1跳关联节点
GET /v1/supply-chain/kg-edges/graph/neighbors/X
references/supply-chain.md
知识图谱边(关联关系)
GET /v1/supply-chain/kg-edges?source_ticker=X
references/supply-chain.md

Social Sentiment & Alternative Data

社交情绪与另类数据

User RequestEndpointReference
Financial Twitter/KOL tweets
GET /v1/twitter-posts?ticker=X
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
用户需求Endpoint参考文档
金融Twitter/KOL推文
GET /v1/twitter-posts?ticker=X
references/alternative-data.md
Reddit帖子(wallstreetbets等板块)
GET /v1/reddit-posts?subreddit=wallstreetbets&ticker=X
references/alternative-data.md
Reddit评论
GET /v1/reddit-comments?ticker=X
references/alternative-data.md
Polymarket预测市场
GET /v1/polymarket/markets?keyword=bitcoin
references/alternative-data.md
Polymarket事件
GET /v1/polymarket/events?keyword=election
references/alternative-data.md
国会/政府交易
GET /v1/government-trading?type=senate-latest
references/alternative-data.md
内部交易(Form 4)
GET /v1/ownership?type=insider-search&ticker=X
references/alternative-data.md
机构持仓(13F)
GET /v1/ownership?type=institutional-latest&ticker=X
references/alternative-data.md

SEC Filings & Transcripts

SEC filings与会议纪要

User RequestEndpointReference
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
用户需求Endpoint参考文档
SEC filings(10-K、10-Q、8-K)
GET /v1/sec-filings?ticker=X&form_type=10-K
references/filings-transcripts.md
搜索SEC filings
GET /v1/sec-filings-search?type=8-K&ticker=X
references/filings-transcripts.md
财报电话会议纪要
GET /v1/transcripts?ticker=X&type=earning_call
references/filings-transcripts.md
播客纪要
GET /v1/transcripts?type=podcast
references/filings-transcripts.md
投资研究报告
GET /v1/investment-research-reports?ticker=X
references/filings-transcripts.md

Calendar & Events

日历与事件

User RequestEndpointReference
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
用户需求Endpoint参考文档
即将发布的财报
GET /v1/calendar?type=earnings-calendar&date_after=...
references/calendar-economics.md
股息日历
GET /v1/calendar?type=dividends-calendar&date_after=...
references/calendar-economics.md
IPO日历
GET /v1/calendar?type=ipos-calendar
references/calendar-economics.md
股票拆分
GET /v1/calendar?type=splits-calendar
references/calendar-economics.md
经济日历
GET /v1/calendar?type=economic-calendar
references/calendar-economics.md

Economics & Macro

经济与宏观数据

User RequestEndpointReference
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
用户需求Endpoint参考文档
国债利率
GET /v1/economics?type=treasury-rates
references/calendar-economics.md
GDP、CPI、失业率等
GET /v1/economics?type=indicators&indicator=GDP
references/calendar-economics.md
FRED系列数据
GET /v1/fred?type=...
references/calendar-economics.md
市场风险溢价
GET /v1/economics?type=market-risk-premium
references/calendar-economics.md

Other Data

其他数据

User RequestEndpointReference
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
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
Companies list
GET /v1/companies
references/other-data.md

用户需求Endpoint参考文档
新闻(股票、加密货币、外汇)
GET /v1/news?type=stock&ticker=X
references/other-data.md
新闻稿
GET /v1/news?type=press-releases&ticker=X
references/other-data.md
市场表现(涨幅榜/跌幅榜)
GET /v1/market-performance?type=gainers
references/other-data.md
ETF/基金持仓
GET /v1/funds?type=etf-holdings&ticker=X
references/other-data.md
ESG评级
GET /v1/esg?type=ratings&ticker=X
references/other-data.md
COT报告
GET /v1/cot-report?type=...
references/other-data.md
众筹数据
GET /v1/crowdfunding?type=...
references/other-data.md
市场交易时间
GET /v1/market-hours?type=...
references/other-data.md
批量数据下载
GET /v1/bulk?type=...
references/other-data.md
上市公司列表
GET /v1/companies
references/other-data.md

Step 3: Make the API Call

步骤3:发起API调用

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:
bash
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.

使用携带Bearer令牌的
curl
命令调用Funda API,调用前请先阅读对应参考文档确认准确的参数名和响应格式。
调用模板:
bash
curl -s -H "Authorization: Bearer $FUNDA_API_KEY" \
  "https://api.funda.ai/v1/<endpoint>?<params>" | python3 -m json.tool
响应格式: 所有端点返回结构为
{"code": "0", "message": "", "data": ...}
。请确认
code
"0"
,非零值表示出现错误,可通过
message
字段查看错误原因。
分页说明: 列表类接口返回结构为
{"items": [...], "page": 0, "page_size": 20, "next_page": 1, "total_count": N}
。页码从0开始,当
next_page
-1
时表示没有更多数据。

Step 4: Handle Common Patterns

步骤4:处理常见场景

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
    )
如果用户提出类似“介绍一下AAPL”的宽泛问题,可合并多个接口调用:
  1. 实时报价(
    /v1/quotes?type=realtime&ticker=AAPL
  2. 公司简介(
    /v1/company-details?type=profile&ticker=AAPL
  3. TTM核心指标(
    /v1/financial-statements?type=key-metrics-ttm&ticker=AAPL
  4. 分析师目标价(
    /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
.
使用批量报价接口获取价格,再调用单独接口获取各股票基本面数据。批量接口支持逗号分隔的股票代码:
/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

如果用户提供的是公司名称而非股票代码,先调用搜索接口:
GET /v1/search?type=name&query=nvidia

Step 5: Respond to the User

步骤5:响应用户

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

清晰呈现数据:
  • 数字保留合适精度:价格保留2位小数,比率保留2-4位小数,大额数字使用千位分隔符或缩写(如$2.8T)
  • 对比类数据使用表格呈现
  • 高亮核心信息(如“当前价格高于/低于分析师目标价”、“财报超出/低于预期”)
  • 时间序列数据优先总结趋势,不要直接输出原始数据
  • 始终注明数据来源:“数据来自Funda AI API”
  • 绝对不要提供交易建议,仅呈现数据由用户自行判断

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
  • references/market-data.md
    — 报价、历史价格、K线、技术指标
  • references/fundamentals.md
    — 财务报表、公司详情、搜索/筛选、分析师数据
  • references/options.md
    — 期权链、Greeks、GEX、期权流、IV、筛选、合约级数据
  • references/supply-chain.md
    — 供应链知识图谱、关联关系、图谱遍历
  • references/alternative-data.md
    — Twitter、Reddit、Polymarket、政府交易、持仓数据
  • references/filings-transcripts.md
    — SEC filings、财报/播客纪要、研究报告
  • references/calendar-economics.md
    — 日历(财报、股息、IPO)、经济数据、国债、FRED
  • references/other-data.md
    — 新闻、市场表现、基金、ESG、COT、众筹、批量数据