# AlphaBook Smart Money MCP (`neeenja/alphabook-smartmoney`) Actor

Zero-config hosted smart-money & volume engine for AI agents: accumulation/distribution verdicts with evidence, not raw volume. 5 read-only tools: volume profile, OBV, A/D, large-order-flow proxy, basket ranking. A/HK/US/global, no API key. Not investment advice.

- **URL**: https://apify.com/neeenja/alphabook-smartmoney.md
- **Developed by:** [Neeen Ja](https://apify.com/neeenja) (community)
- **Categories:** MCP servers, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 analysis calls

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AlphaBook Smart Money MCP

Smart-money / order-flow signal engine as a remote MCP server. It gives your agent **accumulation/distribution verdicts with evidence and invalidation** — not a pile of raw volume. Five tools cover volume profile, OBV trend, accumulation/distribution line, large-order-flow proxy and a basket smart-money ranking. All metrics are pure volume-derived and work on A-shares, HK, US and global markets through free public data. No API key. **Not investment advice.**

> **Honest boundary:** the free source provides daily OHLCV only — no tick-level or per-level trades — so "large order flow" is a **proxy** (volume spike + direction), not real order flow. OBV/A-D are sentiment indicators that can go flat; all outputs carry `NOT_ADVICE`.

### Tools

| Tool | Event | Returns |
|------|-------|---------|
| `get_volume_profile` | tool-call $0.02 | POC + 70% value area (VAH/VAL) + price position |
| `get_obv_trend` | tool-call $0.02 | OBV slope + bullish/bearish divergence vs price |
| `get_accumulation_dist` | tool-call $0.02 | A/D line: accumulation vs distribution verdict |
| `detect_large_order_flow` | tool-call $0.02 | Volume-spike proxy: net up/down bias of abnormal-volume days |
| `rank_smartmoney` | **screen-call $0.05** | Composite smart-money ranking of up to 10 codes |

### Connect (MCP client)

```
https://neeenja--alphabook-smartmoney.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

POST JSON-RPC: `initialize`, `tools/list`, `tools/call`. Example:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "get_volume_profile", "arguments": { "code": "600519" } }
}
```

### Pricing

Pay-per-event. `initialize` and `tools/list` are free. Each analysis call is **$0.02**; a composite basket ranking (`rank_smartmoney`) is **$0.05** because it scores up to 10 symbols.

### Data sources & honest limits

- **Klines:** Tencent `gtimg.cn` (A/HK/US) and Yahoo (global). Free, no key.
- **Large-order proxy:** abnormal volume (≥2× 20-day avg) with direction — not real tick flow.
- Missing data → `n/a`, never a fabricated `0`.
- Every output carries a `NOT_ADVICE` disclaimer.

***

## AlphaBook 聪明钱 MCP

聪明钱 / 资金流信号引擎，以远程 MCP 服务器形式提供。它给 agent 的是 **收集/派发判定 + 证据 + 失效位**，而非一堆原始成交量。五个工具覆盖量价分布、OBV 趋势、收集派发线、异常放量代理与篮子聪明钱排名。全部纯量价派生，支持 A 股、港股、美股与全球市场，免费公开数据，无需 API Key。**不构成投资建议。**

> **诚实边界：** 免费源只有日线 OHLCV，无逐笔/逐档成交，故「大单资金流」为**代理**（异常放量 + 方向），非真实订单流。OBV/A-D 为情绪指标会钝化；所有输出带 `NOT_ADVICE`。

### 工具

| 工具 | 计费事件 | 返回 |
|------|----------|------|
| `get_volume_profile` | tool-call $0.02 | 控制点 POC + 70% 价值区（VAH/VAL）+ 现价位置 |
| `get_obv_trend` | tool-call $0.02 | OBV 斜率 + 相对价格的看跌/看涨背离 |
| `get_accumulation_dist` | tool-call $0.02 | A/D 线：收集 vs 派发判定 |
| `detect_large_order_flow` | tool-call $0.02 | 放量代理：异常放量日的净涨跌倾向 |
| `rank_smartmoney` | **screen-call $0.05** | 最多 10 只标的的综合聪明钱排名 |

### 连接（MCP 客户端）

```
https://neeenja--alphabook-smartmoney.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

发送 JSON-RPC：`initialize`、`tools/list`、`tools/call`。示例：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "get_volume_profile", "arguments": { "code": "600519" } }
}
```

### 计费

按事件付费。`initialize` 与 `tools/list` 免费。每次分析调用 **$0.02**；篮子聪明钱排名（`rank_smartmoney`）为 **$0.05**，因其最多评分 10 只标的。

### 数据源与诚实边界

- **K 线：** 腾讯 `gtimg.cn`（A/港/美）与 Yahoo（全球），免费、无 Key。
- **大单代理：** 异常放量（≥2×20 日均量）加方向，非真实逐笔资金流。
- 数据缺失 → 返回 `n/a`，绝不编造 `0`。
- 所有输出均带 `NOT_ADVICE` 免责声明。

***

## AlphaBook 聰明錢 MCP

聰明錢 / 資金流訊號引擎，以遠端 MCP 伺服器形式提供。它給 agent 的是 **收集/派發判定 + 證據 + 失效位**，而非一堆原始成交量。五個工具涵蓋量價分佈、OBV 趨勢、收集派發線、異常放量代理與籃子聰明錢排名。全部純量價派生，支援 A 股、港股、美股與全球市場，免費公開資料，無需 API Key。**不構成投資建議。**

> **誠實邊界：** 免費源只有日線 OHLCV，無逐筆/逐檔成交，故「大單資金流」為**代理**（異常放量 + 方向），非真實訂單流。OBV/A-D 為情緒指標會鈍化；所有輸出附 `NOT_ADVICE`。

### 工具

| 工具 | 計費事件 | 回傳 |
|------|----------|------|
| `get_volume_profile` | tool-call $0.02 | 控制點 POC + 70% 價值區（VAH/VAL）+ 現價位置 |
| `get_obv_trend` | tool-call $0.02 | OBV 斜率 + 相對價格的看跌/看漲背離 |
| `get_accumulation_dist` | tool-call $0.02 | A/D 線：收集 vs 派發判定 |
| `detect_large_order_flow` | tool-call $0.02 | 放量代理：異常放量日的淨漲跌傾向 |
| `rank_smartmoney` | **screen-call $0.05** | 最多 10 檔標的的綜合聰明錢排名 |

### 連線（MCP 用戶端）

```
https://neeenja--alphabook-smartmoney.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

發送 JSON-RPC：`initialize`、`tools/list`、`tools/call`。範例：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "get_volume_profile", "arguments": { "code": "600519" } }
}
```

### 計費

按事件付費。`initialize` 與 `tools/list` 免費。每次分析呼叫 **$0.02**；籃子聰明錢排名（`rank_smartmoney`）為 **$0.05**，因其最多評分 10 檔標的。

### 資料來源與誠實邊界

- **K 線：** 騰訊 `gtimg.cn`（A/港/美）與 Yahoo（全球），免費、無需 Key。
- **大單代理：** 異常放量（≥2×20 日均量）加方向，非真實逐筆資金流。
- 資料缺失 → 回傳 `n/a`，絕不編造 `0`。
- 所有輸出均附 `NOT_ADVICE` 免責聲明。

# Actor input Schema

## Actor input object example

```json
{}
```

# Actor output Schema

## `mcpEndpoint` (type: `string`):

Streamable HTTP MCP endpoint of this Actor run. Connect an MCP client here (Authorization: Bearer \<APIFY_TOKEN>). POST JSON-RPC messages: initialize, tools/list, tools/call.

## `tools` (type: `string`):

Comma-separated list of the 5 tools: get_volume_profile, get_obv_trend, get_accumulation_dist, detect_large_order_flow, rank_smartmoney.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("neeenja/alphabook-smartmoney").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("neeenja/alphabook-smartmoney").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call neeenja/alphabook-smartmoney --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neeenja/alphabook-smartmoney"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8LlTgkmBN1u4lxpFp/builds/x6uY1e3iVbXuaTUza/openapi.json