Longbridge Openapi

# Longbridge OpenAPI

Longbridge Securities OpenAPI SDK, supporting Hong Kong and US stock trading, real-time market data subscription, and account management.

## Introduction

Longbridge OpenAPI Skill is an AI skill package integrated with Longbridge Securities Open API, allowing you to interact with OpenClaw using natural language to easily complete stock market queries, trade orders, account management, and other operations.

## Core Features

### 📊 Market Data
- **Real-time Market Subscription**: Subscribe to real-time market feeds for Hong Kong stocks, US stocks, and A-shares
- **Stock Quote Query**: Get real-time data such as latest price, volume, price change, etc.
- **Candlestick Data**: Support multiple periods including minute, day, week, month, and year
- **Static Information**: Query basic information such as stock name, exchange, currency, lot size, etc.

### 💰 Trading Features
- **Smart Order Placement**: Support various order types including limit order, market order, enhanced limit order, etc.
- **Order Management**: Cancel orders, modify orders
- **Order Query**: View today's orders, historical orders, and trade records
- **Multi-market Support**: Coverage of Hong Kong stocks, US stocks, and A-shares

### 💼 Account Management
- **Fund Query**: View account balance, buying power, and net assets in real-time
- **Position Management**: Query current positions, cost price, market value, and other information
- **Multi-currency Support**: Support multiple currencies including HKD, USD, CNY, etc.

## Supported Markets

| Market | Code Format | Examples |
|--------|------------|----------|
| 🇭🇰 Hong Kong | `XXX.HK` | `700.HK` (Tencent), `9988.HK` (Alibaba) |
| 🇺🇸 US Stocks | `XXX.US` | `AAPL.US` (Apple), `TSLA.US` (Tesla) |
| 🇨🇳 A-Shares | `XXX.SH/SZ` | `000001.SZ` (Ping An Bank), `600519.SH` (Moutai) |

## Configuration Guide

### 1. Obtain API Credentials

Visit [Longbridge Open Platform](https://open.longportapp.com/) to register an account and crea...

# Longbridge OpenAPI Skill

长桥证券 OpenAPI 技能包，支持港美股交易、实时行情订阅和账户管理。

## 功能特性

### 📊 行情数据
- ✅ 实时行情订阅（港股、美股、A股）
- ✅ 获取股票实时报价（最新价、成交量、涨跌幅等）
- ✅ 历史K线数据（支持分钟、日、周、月、年线）
- ✅ 股票静态信息查询（名称、交易所、货币等）

### 💰 交易功能
- ✅ 提交订单（限价单、市价单、增强限价单等）
- ✅ 撤销订单
- ✅ 查询当日订单
- ✅ 查询历史订单和成交记录

### 💼 账户管理
- ✅ 查询账户资金余额
- ✅ 查询持仓列表
- ✅ 多币种支持（港币、美元、人民币）

## 安装配置

### 1. 获取 API 密钥

访问 [Longbridge 开放平台](https://open.longportapp.com/) 注册并获取：
- `App Key`
- `App Secret`
- `Access Token`

### 2. 配置环境变量

在使用本 skill 之前，需要设置以下环境变量：

```bash
export LONGBRIDGE_APP_KEY="your_app_key"
export LONGBRIDGE_APP_SECRET="your_app_secret"
export LONGBRIDGE_ACCESS_TOKEN="your_access_token"
```

或者在 `~/.bashrc` / `~/.zshrc` 中添加：

```bash
# Longbridge API 配置
export LONGBRIDGE_APP_KEY="your_app_key"
export LONGBRIDGE_APP_SECRET="your_app_secret"
export LONGBRIDGE_ACCESS_TOKEN="your_access_token"
```

### 3. 安装依赖

本 skill 会自动安装 `longbridge` Python SDK (>=0.2.77)

## 使用方法

### 在 ClawHub 安装

1. 访问 ClawHub 网站
2. 搜索 "longbridge" skill
3. 点击安装
4. 配置环境变量（见上方）

### 在 OpenClaw 中使用

安装后，可以直接通过自然语言与 OpenClaw 交互：

```
# 查询行情
查询腾讯和阿里巴巴的最新股价

# 获取K线数据
获取苹果股票最近30天的日K线数据

# 查询账户
我的账户余额是多少？

# 查看持仓
我持有哪些股票？

# 下单交易
以320港元的价格买入100股腾讯
```

## 支持的市场

- 🇭🇰 **港股**: 使用后缀 `.HK`（如 `700.HK` - 腾讯）
- 🇺🇸 **美股**: 使用后缀 `.US`（如 `AAPL.US` - 苹果）
- 🇨🇳 **A股**: 使用后缀 `.SH` 或 `.SZ`（如 `000001.SZ` - 平安银行）

## API 工具列表

### 行情相关
- `quote_subscribe` - 订阅实时行情
- `get_realtime_quote` - 获取实时报价
- `get_static_info` - 获取股票静态信息
- `get_candlesticks` - 获取K线数据

### 交易相关
- `submit_order` - 提交订单
- `cancel_order` -...