# 东方财富数据API接口文档

## 1. 股票实时行情接口

### 接口名称
获取股票实时行情数据

### 请求地址
```
GET https://push2.eastmoney.com/api/qt/ulist.np/get
```

### 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| fltt | 是 | int | 固定值2，表示返回浮动行情 |
| fields | 是 | string | 指定返回字段，多个字段用逗号分隔 |
| secids | 是 | string | 证券代码列表，多个用逗号分隔，格式：市场代码.证券代码 |
| _ | 否 | long | 时间戳，防止缓存 |

### 字段说明
- f2: 最新价
- f3: 涨跌幅（百分比）
- f4: 涨跌额
- f6: 成交额
- f7: 振幅
- f8: 换手率
- f104: 上涨家数
- f105: 下跌家数
- f106: 平盘家数
- f12: 代码
- f13: 市场标识（0=深市，1=沪市）
- f14: 名称

### 响应示例
```json
{
    "rc": 0,
    "rt": 11,
    "svr": 175644146,
    "lt": 1,
    "full": 1,
    "dlmkts": "",
    "data": {
        "total": 5,
        "diff": [
            {
                "f2": 3975.1,
                "f3": -0.28,
                "f4": -11.12,
                "f12": "000001",
                "f13": 1,
                "f14": "上证指数"
            }
        ]
    }
}
```

## 2. 资金流向接口

### 接口名称
获取股票资金流向数据

### 请求地址
```
GET https://push2.eastmoney.com/api/qt/stock/fflow/kline/get
```

### 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| secid | 是 | string | 证券代码，格式：市场代码.证券代码 |
| lmt | 否 | int | 返回数据条数限制 |

### 响应示例
```json
{
    "rc": 0,
    "rt": 11,
    "svr": 175644146,
    "lt": 1,
    "full": 1,
    "data": {
        "klines": [
            "2026-04-13 09:31,-701182480.0,1424552304.0,-721579776.0,-1533228544.0,832046064.0"
        ]
    }
}
```

## 3. 板块资金流向接口

### 接口名称
获取板块资金流向数据

### 请求地址
```
GET https://data.eastmoney.com/dataapi/bkzj/getbkzj
```

### 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| key | 是 | string | 资金流向时间维度（f62=今日，f164=5日，f174=10日） |
| code | 是 | string | 板块分类（m:90+s:4=行业，m:90+e:4=概念，m:90+t:3=主题，m:90+t:1=地域） |

### 响应示例
```json
{
    "data": {
        "diff": [
            {
                "f12": "BK0159",
                "f14": "江苏板块",
                "f62": 582064288,
                "f164": -416584320,
                "f174": -1208234560
            }
        ]
    }
}
```

## 4. 基金实时估值接口

### 接口名称
获取基金实时估值数据

### 请求地址
```
GET https://fundgz.1234567.com.cn/js/{基金代码}.js
```

### 响应示例
```javascript
jsonpgz({
    "fundcode": "018957",
    "name": "中航机遇领航混合发起C",
    "jzrq": "2026-04-10",
    "dwjz": "4.1799",
    "gsz": "4.1999",
    "gszzl": "0.48",
    "gztime": "2026-04-13 11:05"
});
```

## 5. 基金信息接口

### 接口名称
获取基金详细信息

### 请求地址
```
GET https://fundmobapi.eastmoney.com/FundMNewApi/FundMNFInfo
```

### 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| Fcodes | 是 | string | 基金代码，多个用逗号分隔 |
| pageSize | 否 | int | 每页数量 |

### 响应示例
```json
{
    "Datas": [
        {
            "FCODE": "018957",
            "SHORTNAME": "中航机遇领航混合发起C",
            "PDATE": "2026-04-10",
            "NAV": "4.1799",
            "ACCNAV": "4.1799",
            "NAVCHGRT": "3.26",
            "ISHAVEREDPACKET": false
        }
    ]
}
```

## 6. 基金搜索接口

### 接口名称
搜索基金产品

### 请求地址
```
GET https://fundsuggest.eastmoney.com/FundSearch/api/FundSearchAPI.ashx
```

### 请求参数
| 参数名 | 必选 | 类型 | 说明 |
|--------|------|------|------|
| m | 是 | int | 固定值9 |
| key | 是 | string | 搜索关键词（需URL编码） |

### 响应示例
```json
{
    "Datas": [
        {
            "CODE": "008569",
            "NAME": "中航瑞智纯债A",
            "JP": "ZHRZCZA",
            "CATEGORY": "700",
            "FTYPE": "债券型-长债",
            "DWJZ": "1.1124",
            "FSRQ": "2026-04-10",
            "MINSG": "10.0",
            "JJGS": "中航基金",
            "JJJL": "茅勇峰",
            "ISBUY": "1"
        }
    ]
}
```

## 通用说明

### 错误处理
所有接口均返回 `rc` 或 `ErrCode` 字段表示请求状态：
- 0 表示成功
- 非0 表示失败，可通过 `ErrMsg` 查看错误信息

### 数据更新频率
1. 股票行情：实时更新（约1秒/次）
2. 资金流向：每15分钟更新
3. 基金净值：每日更新（T+1日）
4. 基金估值：盘中实时估算（约1分钟/次）

### 注意事项
1. 所有接口均存在跨域限制，生产环境建议通过后端代理
2. 高频访问可能导致IP被封，建议合理控制请求频率
3. 部分接口参数需要URL编码（如中文关键词）
4. 基金代码需区分市场（0=深市，1=沪市，101=国际）

### 示例代码（JavaScript）
```javascript
// 获取股票行情
async function getStockQuotes(codes) {
  const marketMap = { sz: 0, sh: 1 };
  const secids = codes.map(code => {
    const [prefix, num] = code.match(/([a-z]+)(\d+)/i).slice(1);
    return `${marketMap[prefix.toLowerCase()]}.${num}`;
  }).join(',');
  
  const res = await fetch(`https://push2.eastmoney.com/api/qt/ulist.np/get?fltt=2&fields=f2,f3,f4&secids=${secids}`);
  return await res.json();
}

// 获取基金信息
async function getFundInfo(fundCodes) {
  const res = await fetch(`https://fundmobapi.eastmoney.com/FundMNewApi/FundMNFInfo?Fcodes=${fundCodes.join(',')}`);
  return await res.json();
}
```