> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MarketPulse

> 面向 Agent 的实时与历史股票市场数据。

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/marketpulse)

MarketPulse 为 Agent 提供股票价格、新闻、财务报表、指标、分析师预期、内部人交易、SEC filings、筛选器和宏观利率数据。

## 安装

```bash theme={null}
npm install -g @aisa-one/cli
aisa skills install marketpulse
```

## Agent 可以做什么？

<CardGroup cols={2}>
  <Card title="价格数据" icon="chart-line">
    获取历史日线、周线和分钟级 intraday bars。
  </Card>

  <Card title="基本面" icon="building-columns">
    查询财务报表、指标、估值和分析师预期。
  </Card>

  <Card title="事件与披露" icon="file-lines">
    读取新闻、SEC filings、内部人交易和 filing items。
  </Card>

  <Card title="筛选与宏观" icon="filter">
    使用股票筛选器、line-item search 和利率数据。
  </Card>
</CardGroup>

## 核心能力

* 股票历史价格和实时快照
* Income statement、balance sheet、cash flow statement
* Financial metrics 和 snapshot
* Analyst estimates
* Insider trades
* SEC filings 与 parsed filing items
* Stock screener 与 line-item search
* Macro interest rates

## 快速开始

```bash theme={null}
# 历史日线
curl "https://api.aisa.one/apis/v1/financials/prices?ticker=AAPL&start_date=2025-01-01&end_date=2025-01-31&interval=day" \
  -H "Authorization: Bearer $AISA_API_KEY"

# 实时财务指标快照
curl "https://api.aisa.one/apis/v1/financials/metrics/snapshot?ticker=AAPL" \
  -H "Authorization: Bearer $AISA_API_KEY"
```

## Python client

用 Python client 时，先把 ticker、日期范围和 interval 明确传入。价格接口通常需要 `start_date`、`end_date` 和 `interval`。

## Endpoint reference

主要 endpoint 位于 [Financial API](/api-reference/financial/get_prices) 和相关 financial reference 页面。

## 使用建议

把 MarketPulse 作为事实数据层；投资结论应结合财报、新闻、价格行为、估值和风险，不要只用单个指标。

## 开始使用

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
npm install -g @aisa-one/cli
aisa skills install marketpulse
```

## 相关

<CardGroup cols={3}>
  <Card title="AIsa Market" icon="chart-line" href="/zh/agent-skills/market">跨资产市场数据。</Card>
  <Card title="US Stock Analyst" icon="magnifying-glass-chart" href="/zh/agent-skills/us-stock-analyst">美股研究报告。</Card>
  <Card title="Stock Analysis" icon="chart-simple" href="/zh/agent-skills/stock-analysis">股票分析工作流。</Card>
</CardGroup>