alpaca_markets 是一个用于与 Alpaca Markets API 进行交互的 Flutter 插件。Alpaca 是一个提供股票交易 API 的平台，允许开发者通过编程方式进行股票交易、获取市场数据等操作。alpaca_markets 插件使得在 Flutter 应用中集成 Alpaca API 变得更加容易。

安装 alpaca_markets 插件

首先，你需要在 pubspec.yaml 文件中添加 alpaca_markets 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  alpaca_markets: ^0.1.0  # 请检查最新版本

然后运行 flutter pub get 来安装依赖。

初始化 Alpaca API

在使用 alpaca_markets 插件之前，你需要初始化 Alpaca API。通常，你需要提供 API 密钥和密钥 ID：

import 'package:alpaca_markets/alpaca_markets.dart';

void main() async {
  AlpacaAPI alpaca = AlpacaAPI(
    apiKey: 'YOUR_API_KEY',
    apiSecret: 'YOUR_API_SECRET',
    isPaper: true,  // 使用纸交易账户
  );

  // 现在你可以使用 alpaca 对象来调用 API
}

获取账户信息

你可以使用 getAccount() 方法来获取账户信息：

void getAccountInfo() async {
  try {
    Account account = await alpaca.getAccount();
    print('Account ID: ${account.id}');
    print('Buying Power: ${account.buyingPower}');
    print('Cash: ${account.cash}');
  } catch (e) {
    print('Error: $e');
  }
}

获取市场数据

你可以使用 getBars() 方法来获取特定股票的历史数据：

void getMarketData() async {
  try {
    List<Bar> bars = await alpaca.getBars(
      symbol: 'AAPL',
      timeframe: TimeFrame.day,
      limit: 10,
    );

    for (var bar in bars) {
      print('Date: ${bar.timestamp}, Open: ${bar.open}, Close: ${bar.close}');
    }
  } catch (e) {
    print('Error: $e');
  }
}

下单交易

你可以使用 placeOrder() 方法来下单：

void placeOrder() async {
  try {
    Order order = await alpaca.placeOrder(
      symbol: 'AAPL',
      qty: 1,
      side: OrderSide.buy,
      type: OrderType.market,
      timeInForce: TimeInForce.day,
    );

    print('Order ID: ${order.id}');
    print('Status: ${order.status}');
  } catch (e) {
    print('Error: $e');
  }
}

获取订单信息

你可以使用 getOrder() 方法来获取特定订单的信息：

void getOrderInfo(String orderId) async {
  try {
    Order order = await alpaca.getOrder(orderId);
    print('Order ID: ${order.id}');
    print('Status: ${order.status}');
    print('Filled Qty: ${order.filledQty}');
  } catch (e) {
    print('Error: $e');
  }
}

取消订单

你可以使用 cancelOrder() 方法来取消订单：

void cancelOrder(String orderId) async {
  try {
    await alpaca.cancelOrder(orderId);
    print('Order $orderId cancelled');
  } catch (e) {
    print('Error: $e');
  }
}

获取持仓信息

你可以使用 getPositions() 方法来获取当前持仓信息：

void getPositions() async {
  try {
    List<Position> positions = await alpaca.getPositions();
    for (var position in positions) {
      print('Symbol: ${position.symbol}, Qty: ${position.qty}, Market Value: ${position.marketValue}');
    }
  } catch (e) {
    print('Error: $e');
  }
}

获取资产信息

你可以使用 getAsset() 方法来获取特定资产的信息：

void getAssetInfo(String symbol) async {
  try {
    Asset asset = await alpaca.getAsset(symbol);
    print('Symbol: ${asset.symbol}');
    print('Name: ${asset.name}');
    print('Exchange: ${asset.exchange}');
  } catch (e) {
    print('Error: $e');
  }
}

获取市场状态

你可以使用 getClock() 方法来获取当前市场状态：

void getMarketStatus() async {
  try {
    Clock clock = await alpaca.getClock();
    print('Market is ${clock.isOpen ? 'open' : 'closed'}');
    print('Next Open: ${clock.nextOpen}');
    print('Next Close: ${clock.nextClose}');
  } catch (e) {
    print('Error: $e');
  }
}

获取日历信息

你可以使用 getCalendar() 方法来获取市场日历信息：

void getCalendar() async {
  try {
    List<Calendar> calendars = await alpaca.getCalendar();
    for (var calendar in calendars) {
      print('Date: ${calendar.date}, Open: ${calendar.open}, Close: ${calendar.close}');
    }
  } catch (e) {
    print('Error: $e');
  }
}