示例#1
0
class Strategy(object):

    __metaclass__ = ABCMeta

    @abstractmethod
    def handle_data(self,):
        raise NotImplementedError()

    def _subscribe(self):
        self._infoKeeper = InfoKepper()
        self._subscribed = []
        self._pNames = {}
        for k, v in self.__dict__.items():
            if isinstance(v, SecurityValueHolder):
                self._subscribed.append(v)
                if not self._pNames:
                    for name in v.dependency:
                        self._pNames[name] = set(v.dependency[name])
                else:
                    for name in self._pNames:
                        if name in v.dependency:
                            self._pNames[name] = self._pNames[name].union(set(v.dependency[name]))

    def _updateTime(self):
        self._current_datetime = None
        for s in self.symbolList:
            if not self.current_datetime:
                self._current_datetime = self.bars.getLatestBarDatetime(s)
                break

    def _updateSubscribing(self):

        values = dict()
        criticalFields = set(['open', 'high', 'low', 'close'])
        if self._pNames:
            for s in self.symbolList:
                if s in self._pNames:
                    securityValue = {}
                    fields = self._pNames[s]

                    for f in fields:
                        try:
                            value = self.bars.getLatestBarValue(s, f)
                            if f not in criticalFields or value != 0.0:
                                securityValue[f] = value
                        except:
                            pass

                    if securityValue:
                        values[s] = securityValue

            for subscriber in self._subscribed:
                subscriber.push(values)

    def _handle_data(self):
        self._orderRecords = []
        self.handle_data()
        self._processOrders()

    @property
    def universe(self):
        u"""

        获取当前所有代码列表(包括指数等非交易型代码)

        :return: list
        """
        return self.symbolList

    @property
    def tradableAssets(self):
        u"""

        获取当前所有可交易证券代码列表

        :return: list
        """
        return self.assets

    @tradableAssets.setter
    def tradableAssets(self, value):
        self.assets = value

    def monitoring(self):
        pass

    @property
    def current_datetime(self):
        u"""

        获取策略当前运行的bar的时间戳

        :return: datetime.datetime
        """
        return self._current_datetime

    def keep(self, label, value, time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供回测后查看

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :return: None
        """
        if not time:
            time = self.current_datetime
        self._infoKeeper.attach(time, label, value)

    def infoView(self):
        u"""

        返回当前所保留的全部用户信息

        :return: pandas.DataFrame
        """
        return self._infoKeeper.view()

    @property
    def cash(self):
        u"""

        返回当前账户现金

        :return: float
        """
        return self._port.currentHoldings['cash']

    def avaliableForSale(self, symbol):
        u"""

        返回指定证券当前可卖出数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[0]

    def avaliableForBuyBack(self, symbol):
        u"""

        返回指定证券当前可买回数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForBuyBack(symbol)[1]

    def avaliableForTrade(self, symbol):
        u"""

        返回指定证券当前账户可交易数量,返回为一个tuple类型,分别为可卖出数量和可买回数量

        :param symbol: 证券代码
        :return: tuple
        """
        currDTTime = self.current_datetime
        currDT = currDTTime.date()
        return self._posBook.avaliableForTrade(symbol, currDT)

    def _processOrders(self):

        signals = []

        currDTTime = self.current_datetime
        if isinstance(currDTTime, dt.datetime):
            currDT = currDTTime.date()
        else:
            currDT = currDTTime

        cashAmount = max(self._port.currentHoldings['cash'], 1e-5)
        for order in self._orderRecords:
            symbol = order['symbol']
            quantity = order['quantity']
            direction = order['direction']
            currValue = self.bars.getLatestBarValue(symbol, 'close')

            multiplier = self._port.assets[symbol].multiplier
            settle = self._port.assets[symbol].settle
            margin = self._port.assets[symbol].margin
            shortable = self._port.assets[symbol].short

            # amount available for buy back or sell
            if direction == 1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[1]
            elif direction == -1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[0]

            fill_cost = quantity * currValue * multiplier * settle * direction

            margin_cost = max(quantity - amount, 0) * currValue * multiplier * margin
            maximumCashCost = max(fill_cost, margin_cost)

            if maximumCashCost <= cashAmount and (direction == 1 or (quantity <= amount or shortable)):
                signal = OrderEvent(currDTTime, symbol, "MKT", quantity, direction)
                self._posBook.updatePositionsByOrder(symbol, currDT, quantity, direction)
                signals.append(signal)
                cashAmount -= maximumCashCost
            elif maximumCashCost > cashAmount:
                if direction == 1:
                    self.logger.warning("{0}: ${1} cash needed to buy the quantity {2} of {3} "
                                        "is less than available cash ${4}"
                                        .format(currDTTime, maximumCashCost, quantity, symbol, cashAmount))
                else:
                    self.logger.warning("{0}: ${1} cash needed to sell the quantity {2} of {3} "
                                        "is less than available cash ${4}"
                                        .format(currDTTime, maximumCashCost, quantity, symbol, cashAmount))
            else:
                self.logger.warning("{0}: short disabled {1} quantity need to be sold {2} "
                                    "is less then the available for sell amount {3}"
                                    .format(currDTTime, symbol, quantity, amount))

        # log the signal informations
        for signal in signals:
            self.logger.info("{0}: {1} Order ID: {2} is sent with quantity {3} and direction {4} on symbol {5}"
                    .format(signal.timeIndex,
                            signal.orderType,
                            signal.orderID,
                            signal.quantity,
                            signal.direction,
                            signal.symbol))
            self.events.put(signal)

    def order_to(self, symbol, direction, quantity):
        u"""

        交易指定证券至指定要求的仓位

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity: 指定要求的仓位
        :return: None
        """
        currentPos = self.secPos[symbol]
        if direction == 1:
            posNeedToBuy = quantity - currentPos
            if posNeedToBuy > 0:
                self.order(symbol, 1, posNeedToBuy)
            elif posNeedToBuy < 0:
                self.order(symbol, -1, -posNeedToBuy)
        elif direction == -1:
            posNeedToSell = quantity + currentPos
            if posNeedToSell > 0:
                self.order(symbol, -1, posNeedToSell)
            elif posNeedToSell < 0:
                self.order(symbol, 1, -posNeedToSell)

    def order(self, symbol, direction, quantity):
        u"""

        交易指定量的指定证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity:交易量
        :return: None
        """

        currDTTime = self.current_datetime

        if symbol not in self.tradableAssets:
            self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is rejected since {1}"
                                " is not a tradable asset!".format(currDTTime, symbol, quantity, direction))
            return

        if quantity % self._port.assets[symbol].minimum != 0:
            self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is not consistent "
                                "with minimum bucket amount seeting. "
                                "Order is discarded!".format(currDTTime, symbol, quantity, direction))
            return

        if quantity > 0 and abs(direction) == 1:
            self._orderRecords.append({'symbol': symbol, 'quantity': quantity, 'direction': direction})
        elif quantity == 0 and abs(direction) == 1:
            pass
        elif quantity < 0:
            raise ValueError("quantity cant't be negative as {0}".format(quantity))
        else:
            raise ValueError("Unrecognized direction {0}".format(direction))



    @property
    def secPos(self):
        u"""

        保存当前证券整体仓位信息(单位,股数)

        :return:
        """
        return self._port.currentPosition

    @property
    def holdings(self):
        u"""

        保存当前证券仓位信息(单位,元)

        :return:
        """
        return self._port.allHoldings[-1]

    @property
    def realizedHoldings(self):
        return self._port.currentHoldings
示例#2
0
class Strategy(object):

    __metaclass__ = ABCMeta

    @abstractmethod
    def handle_data(self):
        return

    def handle_fill(self, event):
        return

    def handle_order(self, event):
        return

    def day_begin(self):
        return

    def _subscribe(self):
        self._infoKeeper = InfoKepper()
        self._plotKeeper = PlotInfoKeeper()
        self._subscribed = []
        self._pNames = set()
        for k, v in self.__dict__.items():
            if k != '_infoKeeper' and k != '_subscribed' and k != '_pNames':
                self._subscribeOneItem(v)

    def _subscribeOneItem(self, new_item):
        if isinstance(new_item, SecurityValueHolder):
            self._subscribed.append(new_item)
            self._pNames = self._pNames.union(new_item._dependency)
        elif isinstance(new_item, list) or isinstance(new_item, set):
            for v in new_item:
                self._subscribeOneItem(v)
        elif isinstance(new_item, dict):
            for v in new_item.values():
                self._subscribeOneItem(v)

    def _updateTime(self):
        self._current_datetime = None
        for s in self.symbolList:
            if not self.current_datetime:
                self._current_datetime = self.bars.getLatestBarDatetime(s)
                break

    def _updateSubscribing(self):

        values = dict()
        if self._pNames:
            for s in self.symbolList:
                securityValue = {}

                for f in self._pNames:
                    try:
                        value = self.bars.getLatestBarValue(s, f)
                        securityValue[f] = value
                    except:
                        pass

                if securityValue:
                    values[s] = securityValue

            for subscriber in self._subscribed:
                subscriber.push(values)

    def _handle_data(self):
        self._orderRecords = []
        self._posTargets = {}
        self.handle_data()
        self._processOrders()

    @property
    def universe(self):
        u"""

        获取当前所有代码列表(包括指数等非交易型代码)

        :return: list
        """
        return self.symbolList

    @property
    def tradableAssets(self):
        u"""

        获取当前所有可交易证券代码列表

        :return: list
        """
        return self.assets

    @tradableAssets.setter
    def tradableAssets(self, value):
        self.assets = value

    def monitoring(self):
        pass

    @property
    def current_datetime(self):
        u"""

        获取策略当前运行的bar的时间戳

        :return: datetime.datetime
        """
        return self._current_datetime

    @current_datetime.setter
    def current_datetime(self, value):
        self._current_datetime = value

    @property
    def current_date(self):
        u"""

        获取当前日期的字符串时间戳,格式为YYYY-MM-DD

        :return: str
        """
        return self._current_datetime.date().__str__()

    @property
    def current_time(self):
        u"""

        获取当前时间的字符串时间戳,格式为HH:MM:SS

        :return: str
        """
        return self._current_datetime.time().__str__()

    def keep(self, name, value, time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供回测后查看

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :return: None
        """
        if not time:
            time = self.current_datetime
        self._infoKeeper.attach(time, name, value)

    def plot(self, name, value, marker=None, line_style='solid', time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供绘图使用

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :param marker: 数据点类型
        :param line_style: 线型
        :return: None
        """

        if not time:
            time = self.current_datetime
        self._plotKeeper.attach(time, name, value, marker, line_style)

    def infoView(self):
        u"""

        返回当前所保留的全部用户信息

        :return: pandas.DataFrame
        """
        return self._infoKeeper.view()

    def plotCurves(self):
        u"""

        返回当前所保留的全部绘图用信息

        :return: pandas.DataFrame
        """
        return self._plotKeeper.curves()

    @property
    def cash(self):
        u"""

        返回当前账户现金

        :return: float
        """
        return self._port.currentHoldings['cash']

    @property
    def portfolioValue(self):
        u"""

        返回当前账户总净值

        :return: float
        """
        return self._port.allHoldings[-1]['total']

    def avaliableForSale(self, symbol):
        u"""

        返回指定证券当前可卖出数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[0]

    def avaliableForBuyBack(self, symbol):
        u"""

        返回指定证券当前可买回数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[1]

    def avaliableForTrade(self, symbol):
        u"""

        返回指定证券当前账户可交易数量,返回为一个tuple类型,分别为可卖出数量和可买回数量

        :param symbol: 证券代码
        :return: tuple
        """
        currDTTime = self.current_datetime
        currDT = dt.datetime(currDTTime.year, currDTTime.month, currDTTime.day)
        return self._posBook.avaliableForTrade(symbol, currDT)

    def _processOrders(self):

        signals = []

        currDTTime = self.current_datetime
        currDT = dt.datetime(currDTTime.year, currDTTime.month, currDTTime.day)

        cashAmount = self._port.currentHoldings['cash']
        for order in self._orderRecords:
            cashAmount = max(cashAmount, 1.e-5)
            symbol = order['symbol']
            quantity = order['quantity']
            direction = order['direction']
            currValue = self.bars.getLatestBarValue(symbol, 'close')

            multiplier = self._port.assets[symbol].multiplier
            settle = self._port.assets[symbol].settle
            margin = self._port.assets[symbol].margin

            # amount available for buy back or sell
            if direction == OrderDirection.BUY:
                fill_cost = quantity * currValue * multiplier * settle
                margin_cost = 0.
            elif direction == OrderDirection.BUY_BACK:
                fill_cost = 0.
                margin_cost = 0.
            elif direction == OrderDirection.SELL:
                fill_cost = 0.
                margin_cost = 0.
            elif direction == OrderDirection.SELL_SHORT:
                fill_cost = 0.
                margin_cost = quantity * currValue * multiplier * margin

            maximumCashCost = max(fill_cost, margin_cost)

            if maximumCashCost <= cashAmount:
                signal = OrderEvent(currDTTime, symbol, "MKT", quantity,
                                    direction)
                self._posBook.updatePositionsByOrder(symbol, currDT, quantity,
                                                     direction)
                signals.append(signal)
                cashAmount -= maximumCashCost
            elif maximumCashCost > cashAmount:
                if direction == OrderDirection.BUY:
                    self.logger.warning(
                        "{0}: ${1} cash needed to buy the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))
                elif direction == OrderDirection.SELL_SHORT:
                    self.logger.warning(
                        "{0}: ${1} cash needed to sell short the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))

        # log the signal informations
        for signal in signals:
            self.logger.info(
                "{0}: {1} Order ID: {2} is sent with quantity {3} and direction {4} on symbol {5}"
                .format(signal.timeIndex, signal.orderType, signal.orderID,
                        signal.quantity, signal.direction, signal.symbol))
            self.events.put(signal)

    def order_to(self, symbol, direction, quantity):
        u"""

        交易指定证券至指定要求的仓位

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity: 指定要求的仓位
        :return: None
        """

        if symbol not in self._posTargets:
            currentPos = self.secPos[symbol]
            self._posTargets[symbol] = currentPos
        else:
            currentPos = self._posTargets[symbol]

        if direction == 1:
            posNeedToBuy = quantity - currentPos
            if posNeedToBuy > 0:
                self.order(symbol, 1, posNeedToBuy)
            elif posNeedToBuy < 0:
                self.order(symbol, -1, -posNeedToBuy)
        elif direction == -1:
            posNeedToSell = quantity + currentPos
            if posNeedToSell > 0:
                self.order(symbol, -1, posNeedToSell)
            elif posNeedToSell < 0:
                self.order(symbol, 1, -posNeedToSell)

    def order(self, symbol, direction, quantity):
        u"""

        交易指定量的指定证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity:交易量
        :return: None
        """

        currDTTime = self.current_datetime

        if symbol not in self.tradableAssets:
            self.logger.warning(
                "{0}: Order for {1} with amount {2} and direction as {3} is rejected since {1}"
                " is not a tradable asset!".format(currDTTime, symbol,
                                                   quantity, direction))
            return

        if quantity % self._port.assets[symbol].minimum != 0:
            self.logger.warning(
                "{0}: Order for {1} with amount {2} and direction as {3} is not consistent "
                "with minimum bucket amount seeting. "
                "Order is discarded!".format(currDTTime, symbol, quantity,
                                             direction))
            return

        if symbol in self.priceLimitTable:
            currValue = self.bars.getLatestBarValue(symbol, 'close')
            low_limit, high_limit = self.priceLimitTable[symbol]
            if currValue <= low_limit and direction < 0:
                self.logger.warning(
                    "{0}: Order for {1} with amount {2} and direction as {3} is not sent "
                    "with market is frozen at {4} lower limit price.".format(
                        currDTTime, symbol, quantity, direction, currValue))
                return
            elif currValue >= high_limit and direction > 0:
                self.logger.warning(
                    "{0}: Order for {1} with amount {2} and direction as {3} is not sent "
                    "with market is frozen at {4} higher limit price.".format(
                        currDTTime, symbol, quantity, direction, currValue))
                return

        if symbol not in self._posTargets:
            self._posTargets[symbol] = self.secPos[symbol]

        if quantity > 0 and direction == 1:
            self._posTargets[symbol] += quantity
            buyback_amount = self.avaliableForBuyBack(symbol)
            if buyback_amount >= quantity:
                self._orderRecords.append({
                    'symbol': symbol,
                    'quantity': quantity,
                    'direction': OrderDirection.BUY_BACK
                })
            else:
                if buyback_amount != 0:
                    self._orderRecords.append({
                        'symbol':
                        symbol,
                        'quantity':
                        buyback_amount,
                        'direction':
                        OrderDirection.BUY_BACK
                    })
                self._orderRecords.append({
                    'symbol': symbol,
                    'quantity': quantity - buyback_amount,
                    'direction': OrderDirection.BUY
                })
        elif quantity > 0 and direction == -1:
            self._posTargets[symbol] -= quantity
            sell_amount = self.avaliableForSale(symbol)
            if sell_amount >= quantity:
                self._orderRecords.append({
                    'symbol': symbol,
                    'quantity': quantity,
                    'direction': OrderDirection.SELL
                })
            else:
                if self._port.assets[symbol].short:
                    if sell_amount != 0:
                        self._orderRecords.append({
                            'symbol':
                            symbol,
                            'quantity':
                            sell_amount,
                            'direction':
                            OrderDirection.SELL
                        })
                    self._orderRecords.append({
                        'symbol':
                        symbol,
                        'quantity':
                        quantity - sell_amount,
                        'direction':
                        OrderDirection.SELL_SHORT
                    })
                else:
                    self.logger.warning(
                        "{0}: short disabled {1} quantity need to be sold {2} "
                        "is less then the available for sell amount {3}.".
                        format(currDTTime, symbol, quantity, sell_amount))

        elif quantity == 0 and abs(direction) == 1:
            pass
        elif quantity < 0:
            raise ValueError(
                "quantity cant't be negative as {0}".format(quantity))
        else:
            raise ValueError("Unrecognized direction {0}".format(direction))

    def order_pct(self, symbol, direction, pct):
        u"""

        交易占当前资产组合指定比例的证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param pct: 比例
        :return: None
        """
        currDTTime = self.current_datetime
        if pct < 0. or pct > 1.0:
            self.logger.warning(
                "{0:}: Percentage order for {1} with percentage {2} and direction {4} is not allowed. "
                "Percentage should be between 0 and 1".format(
                    currDTTime, symbol, pct, direction))
            return

        portfolio_value = self.portfolioValue
        currValue = self.bars.getLatestBarValue(symbol, 'close')
        rought_amount = int(portfolio_value * pct / currValue)
        actual_amount = rought_amount // self._port.assets[
            symbol].minimum * self._port.assets[symbol].minimum
        self.order(symbol, direction, actual_amount)

    def order_to_pct(self, symbol, direction, pct):
        u"""

        交易证券至占当前组合指定比例

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param pct: 目标比例
        :return: None
        """
        currDTTime = self.current_datetime
        if pct < 0. or pct > 1.0:
            self.logger.warning(
                "{0:}: Percentage order for {1} with percentage {2} and direction {4} is not allowed. "
                "Percentage should be between 0 and 1".format(
                    currDTTime, symbol, pct, direction))
            return

        portfolio_value = self.portfolioValue
        currValue = self.bars.getLatestBarValue(symbol, 'close')
        rought_amount = int(portfolio_value * pct / currValue)
        actual_amount = rought_amount // self._port.assets[
            symbol].minimum * self._port.assets[symbol].minimum
        self.order_to(symbol, direction, actual_amount)

    def send_targets(self, target_positions):

        for name in target_positions:
            pos = target_positions[name]
            if pos > 0.:
                self.order_to_pct(name, 1, pos)
            elif pos < 0.:
                self.order_to_pct(name, -1, pos)

    @property
    def liveOrders(self):
        return self._port.orderBook.liveOrders()

    def secPosDetail(self, secID):
        try:
            return self._port.positionsBook.positions(secID).view()
        except KeyError:
            return pd.DataFrame()

    @property
    def secPos(self):
        u"""

        保存当前证券整体仓位信息(单位,股数)

        :return: int
        """
        return self._port.currentPosition

    @property
    def holdings(self):
        u"""

        保存当前证券仓位信息(单位,元)

        :return: float
        """
        return self._port.allHoldings[-1]

    @property
    def realizedHoldings(self):
        return self._port.currentHoldings

    def checkingPriceLimit(self):
        self.priceLimitTable = {}
        # only work for securities close at the same time
        for s in self.tradableAssets:
            try:
                previous_day_close = self.bars.getPreviousDayValue(s, 'close')
            except KeyError:
                previous_day_close = np.nan

            if not np.isnan(previous_day_close):
                price_limit = self._port.assets[s].price_limit
                self.priceLimitTable[s] = (
                    1.005 - price_limit) * previous_day_close, (
                        0.995 + price_limit) * previous_day_close,
示例#3
0
class Strategy(object):

    __metaclass__ = ABCMeta

    @abstractmethod
    def handle_data(self, ):
        raise NotImplementedError()

    def _subscribe(self):
        self._infoKeeper = InfoKepper()
        self._subscribed = []
        self._pNames = {}
        for k, v in self.__dict__.items():
            if isinstance(v, SecurityValueHolder):
                self._subscribed.append(v)
                if not self._pNames:
                    for name in v.dependency:
                        self._pNames[name] = set(v.dependency[name])
                else:
                    for name in self._pNames:
                        if name in v.dependency:
                            self._pNames[name] = self._pNames[name].union(
                                set(v.dependency[name]))

    def _updateSubscribing(self):

        self._current_datetime = None
        values = dict()
        criticalFields = set(['open', 'high', 'low', 'close'])
        if self._pNames:
            for s in self.symbolList:
                if s in self._pNames:
                    securityValue = {}
                    fields = self._pNames[s]

                    for f in fields:
                        try:
                            value = self.bars.getLatestBarValue(s, f)
                            if not self.current_datetime:
                                self._current_datetime = self.bars.getLatestBarDatetime(
                                    s)
                            if f not in criticalFields or value != 0.0:
                                securityValue[f] = value
                        except:
                            pass

                    if securityValue:
                        values[s] = securityValue

            for subscriber in self._subscribed:
                subscriber.push(values)

    def _handle_data(self):
        self._orderRecords = []
        self.handle_data()
        self._processOrders()

    @property
    def universe(self):
        return self.symbolList

    @property
    def tradableAssets(self):
        return self.assets

    @tradableAssets.setter
    def tradableAssets(self, value):
        self.assets = value

    def monitoring(self):
        pass

    @property
    def current_datetime(self):
        return self._current_datetime

    def keep(self, label, value, time=None):
        if not time:
            time = self.current_datetime
        self._infoKeeper.attach(time, label, value)

    def infoView(self):
        return self._infoKeeper.view()

    @property
    def cash(self):
        return self._port.currentHoldings['cash']

    def avaliableForSale(self, symbol):
        return self.avaliableForTrade(symbol)[0]

    def avaliableForBuyBack(self, symbol):
        return self.avaliableForBuyBack(symbol)[1]

    def avaliableForTrade(self, symbol):
        currDTTime = self.current_datetime
        currDT = currDTTime.date()
        return self._posBook.avaliableForTrade(symbol, currDT)

    def _processOrders(self):

        signals = []

        cashAmount = max(self._port.currentHoldings['cash'], 1e-5)
        for order in self._orderRecords:
            symbol = order['symbol']
            quantity = order['quantity']
            direction = order['direction']
            currDTTime = self.bars.getLatestBarDatetime(symbol)
            currDT = currDTTime.date()
            currValue = self.bars.getLatestBarValue(symbol, 'close')

            multiplier = self._port.assets[symbol].multiplier
            settle = self._port.assets[symbol].settle
            margin = self._port.assets[symbol].margin
            shortable = self._port.assets[symbol].short

            # amount available for buy back or sell
            if direction == 1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[1]
            elif direction == -1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[0]

            fill_cost = quantity * currValue * multiplier * settle * direction

            margin_cost = max(quantity - amount,
                              0) * currValue * multiplier * margin
            maximumCashCost = max(fill_cost, margin_cost)

            if maximumCashCost <= cashAmount and (direction == 1 or
                                                  (quantity <= amount
                                                   or shortable)):
                signal = OrderEvent(currDTTime, symbol, "MKT", quantity,
                                    direction)
                self._posBook.updatePositionsByOrder(symbol, currDT, quantity,
                                                     direction)
                signals.append(signal)
                cashAmount -= maximumCashCost
            elif maximumCashCost > cashAmount:
                if direction == 1:
                    self.logger.warning(
                        "{0}: ${1} cash needed to buy the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))
                else:
                    self.logger.warning(
                        "{0}: ${1} cash needed to sell the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))
            else:
                self.logger.warning(
                    "{0}: short disabled {1} quantity need to be sold {2} "
                    "is less then the available for sell amount {3}".format(
                        currDTTime, symbol, quantity, amount))

        # log the signal informations
        for signal in signals:
            self.logger.info(
                "{0}: {1} Order ID: {2} is sent with quantity {3} and direction {4} on symbol {5}"
                .format(signal.timeIndex, signal.orderType, signal.orderID,
                        signal.quantity, signal.direction, signal.symbol))
            self.events.put(signal)

    def order_to(self, symbol, direction, quantity):
        currentPos = self.secPos[symbol]
        if direction == 1:
            posNeedToBuy = quantity - currentPos
            if posNeedToBuy > 0:
                self.order(symbol, 1, posNeedToBuy)
            elif posNeedToBuy < 0:
                self.order(symbol, -1, -posNeedToBuy)
        elif direction == -1:
            posNeedToSell = quantity + currentPos
            if posNeedToSell > 0:
                self.order(symbol, -1, posNeedToSell)
            elif posNeedToSell < 0:
                self.order(symbol, 1, -posNeedToSell)

    def order(self, symbol, direction, quantity):

        if symbol not in self.tradableAssets:
            self.logger.warning(
                "Order for {0} with amount {1} and direction as {2} is rejected since {0}"
                " is not a tradable asset!".format(symbol, quantity,
                                                   direction))
            return

        if quantity % self._port.assets[symbol].minimum != 0:
            self.logger.warning(
                "Order for {0} with amount {1} and direction as {2} is not consistent "
                "with minimum bucket amount seeting. "
                "Order is discarded!".format(symbol, quantity, direction))
            return

        if quantity > 0:
            self._orderRecords.append({
                'symbol': symbol,
                'quantity': quantity,
                'direction': direction
            })
        elif quantity == 0 and abs(direction) == 1:
            pass
        else:
            raise ValueError("Unrecognized direction %d" % direction)

    @property
    def secPos(self):
        return self._port.currentPosition

    @property
    def holdings(self):
        return self._port.allHoldings[-1]

    @property
    def realizedHoldings(self):
        return self._port.currentHoldings
示例#4
0
class Strategy(object):

    __metaclass__ = ABCMeta

    @abstractmethod
    def handle_data(self, ):
        raise NotImplementedError()

    def _subscribe(self):
        self._infoKeeper = InfoKepper()
        self._subscribed = []
        self._pNames = {}
        for k, v in self.__dict__.items():
            if isinstance(v, SecurityValueHolder):
                self._subscribed.append(v)
                if not self._pNames:
                    for name in v.dependency:
                        self._pNames[name] = set(v.dependency[name])
                else:
                    for name in self._pNames:
                        if name in v.dependency:
                            self._pNames[name] = self._pNames[name].union(
                                set(v.dependency[name]))

    def _updateTime(self):
        self._current_datetime = None
        for s in self.symbolList:
            if not self.current_datetime:
                self._current_datetime = self.bars.getLatestBarDatetime(s)
                break

    def _updateSubscribing(self):

        values = dict()
        criticalFields = set(['open', 'high', 'low', 'close'])
        if self._pNames:
            for s in self.symbolList:
                if s in self._pNames:
                    securityValue = {}
                    fields = self._pNames[s]

                    for f in fields:
                        try:
                            value = self.bars.getLatestBarValue(s, f)
                            if f not in criticalFields or value != 0.0:
                                securityValue[f] = value
                        except:
                            pass

                    if securityValue:
                        values[s] = securityValue

            for subscriber in self._subscribed:
                subscriber.push(values)

    def _handle_data(self):
        self._orderRecords = []
        self.handle_data()
        self._processOrders()

    @property
    def universe(self):
        u"""

        获取当前所有代码列表(包括指数等非交易型代码)

        :return: list
        """
        return self.symbolList

    @property
    def tradableAssets(self):
        u"""

        获取当前所有可交易证券代码列表

        :return: list
        """
        return self.assets

    @tradableAssets.setter
    def tradableAssets(self, value):
        self.assets = value

    def monitoring(self):
        pass

    @property
    def current_datetime(self):
        u"""

        获取策略当前运行的bar的时间戳

        :return: datetime.datetime
        """
        return self._current_datetime

    def keep(self, label, value, time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供回测后查看

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :return: None
        """
        if not time:
            time = self.current_datetime
        self._infoKeeper.attach(time, label, value)

    def infoView(self):
        u"""

        返回当前所保留的全部用户信息

        :return: pandas.DataFrame
        """
        return self._infoKeeper.view()

    @property
    def cash(self):
        u"""

        返回当前账户现金

        :return: float
        """
        return self._port.currentHoldings['cash']

    def avaliableForSale(self, symbol):
        u"""

        返回指定证券当前可卖出数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[0]

    def avaliableForBuyBack(self, symbol):
        u"""

        返回指定证券当前可买回数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForBuyBack(symbol)[1]

    def avaliableForTrade(self, symbol):
        u"""

        返回指定证券当前账户可交易数量,返回为一个tuple类型,分别为可卖出数量和可买回数量

        :param symbol: 证券代码
        :return: tuple
        """
        currDTTime = self.current_datetime
        currDT = currDTTime.date()
        return self._posBook.avaliableForTrade(symbol, currDT)

    def _processOrders(self):

        signals = []

        currDTTime = self.current_datetime
        if isinstance(currDTTime, dt.datetime):
            currDT = currDTTime.date()
        else:
            currDT = currDTTime

        cashAmount = max(self._port.currentHoldings['cash'], 1e-5)
        for order in self._orderRecords:
            symbol = order['symbol']
            quantity = order['quantity']
            direction = order['direction']
            currValue = self.bars.getLatestBarValue(symbol, 'close')

            multiplier = self._port.assets[symbol].multiplier
            settle = self._port.assets[symbol].settle
            margin = self._port.assets[symbol].margin

            # amount available for buy back or sell
            if direction == 1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[1]
            elif direction == -1:
                amount = self._posBook.avaliableForTrade(symbol, currDT)[0]

            fill_cost = quantity * currValue * multiplier * settle * direction

            margin_cost = max(quantity - amount,
                              0) * currValue * multiplier * margin
            maximumCashCost = max(fill_cost, margin_cost)

            if maximumCashCost <= cashAmount and (direction == 1
                                                  or quantity <= amount):
                signal = OrderEvent(currDTTime, symbol, "MKT", quantity,
                                    direction)
                self._posBook.updatePositionsByOrder(symbol, currDT, quantity,
                                                     direction)
                signals.append(signal)
                cashAmount -= maximumCashCost
            elif maximumCashCost > cashAmount:
                if direction == 1:
                    self.logger.warning(
                        "{0}: ${1} cash needed to buy the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))
                else:
                    self.logger.warning(
                        "{0}: ${1} cash needed to sell the quantity {2} of {3} "
                        "is less than available cash ${4}".format(
                            currDTTime, maximumCashCost, quantity, symbol,
                            cashAmount))
            else:
                self.logger.warning(
                    "{0}: short disabled {1} quantity need to be sold {2} "
                    "is less then the available for sell amount {3}".format(
                        currDTTime, symbol, quantity, amount))

        # log the signal informations
        for signal in signals:
            self.logger.info(
                "{0}: {1} Order ID: {2} is sent with quantity {3} and direction {4} on symbol {5}"
                .format(signal.timeIndex, signal.orderType, signal.orderID,
                        signal.quantity, signal.direction, signal.symbol))
            self.events.put(signal)

    def order_to(self, symbol, direction, quantity):
        u"""

        交易指定证券至指定要求的仓位

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity: 指定要求的仓位
        :return: None
        """
        currentPos = self.secPos[symbol]
        if direction == 1:
            posNeedToBuy = quantity - currentPos
            if posNeedToBuy > 0:
                self.order(symbol, 1, posNeedToBuy)
            elif posNeedToBuy < 0:
                self.order(symbol, -1, -posNeedToBuy)
        elif direction == -1:
            posNeedToSell = quantity + currentPos
            if posNeedToSell > 0:
                self.order(symbol, -1, posNeedToSell)
            elif posNeedToSell < 0:
                self.order(symbol, 1, -posNeedToSell)

    def order(self, symbol, direction, quantity):
        u"""

        交易指定量的指定证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity:交易量
        :return: None
        """

        currDTTime = self.current_datetime

        if symbol not in self.tradableAssets:
            self.logger.warning(
                "{0}: Order for {1} with amount {2} and direction as {3} is rejected since {1}"
                " is not a tradable asset!".format(currDTTime, symbol,
                                                   quantity, direction))
            return

        if quantity % self._port.assets[symbol].minimum != 0:
            self.logger.warning(
                "{0}: Order for {1} with amount {2} and direction as {3} is not consistent "
                "with minimum bucket amount seeting. "
                "Order is discarded!".format(currDTTime, symbol, quantity,
                                             direction))
            return

        if quantity > 0 and abs(direction) == 1:
            self._orderRecords.append({
                'symbol': symbol,
                'quantity': quantity,
                'direction': direction
            })
        elif quantity == 0 and abs(direction) == 1:
            pass
        elif quantity < 0:
            raise ValueError(
                "quantity cant't be negative as {0}".format(quantity))
        else:
            raise ValueError("Unrecognized direction {0}".format(direction))

    @property
    def secPos(self):
        u"""

        保存当前证券整体仓位信息(单位,股数)

        :return:
        """
        return self._port.currentPosition

    @property
    def holdings(self):
        u"""

        保存当前证券仓位信息(单位,元)

        :return:
        """
        return self._port.allHoldings[-1]

    @property
    def realizedHoldings(self):
        return self._port.currentHoldings
示例#5
0
class Strategy(object):

    __metaclass__ = ABCMeta

    @abstractmethod
    def handle_data(self):
        return

    def handle_fill(self, event):
        return

    def handle_order(self, event):
        return

    def day_begin(self):
        return

    def _subscribe(self):
        self._infoKeeper = InfoKepper()
        self._plotKeeper = PlotInfoKeeper()
        self._subscribed = []
        self._pNames = set()
        for k, v in self.__dict__.items():
            if k != '_infoKeeper' and k != '_subscribed' and k != '_pNames':
                self._subscribeOneItem(v)

    def _subscribeOneItem(self, new_item):
        if isinstance(new_item, SecurityValueHolder):
            self._subscribed.append(new_item)
            self._pNames = self._pNames.union(new_item._dependency)
        elif isinstance(new_item, list) or isinstance(new_item, set):
            for v in new_item:
                self._subscribeOneItem(v)
        elif isinstance(new_item, dict):
            for v in new_item.values():
                self._subscribeOneItem(v)

    def _updateTime(self):
        self._current_datetime = None
        for s in self.symbolList:
            if not self.current_datetime:
                self._current_datetime = self.bars.getLatestBarDatetime(s)
                break

    def _updateSubscribing(self):

        values = dict()
        if self._pNames:
            for s in self.symbolList:
                securityValue = {}

                for f in self._pNames:
                    try:
                        value = self.bars.getLatestBarValue(s, f)
                        securityValue[f] = value
                    except:
                        pass

                if securityValue:
                    values[s] = securityValue

            for subscriber in self._subscribed:
                subscriber.push(values)

    def _handle_data(self):
        self._orderRecords = []
        self._posTargets = {}
        self.handle_data()
        self._processOrders()

    @property
    def universe(self):
        u"""

        获取当前所有代码列表(包括指数等非交易型代码)

        :return: list
        """
        return self.symbolList

    @property
    def tradableAssets(self):
        u"""

        获取当前所有可交易证券代码列表

        :return: list
        """
        return self.assets

    @tradableAssets.setter
    def tradableAssets(self, value):
        self.assets = value

    def monitoring(self):
        pass

    @property
    def current_datetime(self):
        u"""

        获取策略当前运行的bar的时间戳

        :return: datetime.datetime
        """
        return self._current_datetime

    @current_datetime.setter
    def current_datetime(self, value):
        self._current_datetime = value

    @property
    def current_date(self):
        u"""

        获取当前日期的字符串时间戳,格式为YYYY-MM-DD

        :return: str
        """
        return self._current_datetime.date().__str__()

    @property
    def current_time(self):
        u"""

        获取当前时间的字符串时间戳,格式为HH:MM:SS

        :return: str
        """
        return self._current_datetime.time().__str__()

    def keep(self, name, value, time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供回测后查看

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :return: None
        """
        if not time:
            time = self.current_datetime
        self._infoKeeper.attach(time, name, value)

    def plot(self, name, value, marker=None, line_style='solid', time=None):
        u"""

        将用户需要保留的信息保存到指定的时间戳下,供绘图使用

        :param label: 指定信息的名称
        :param value: 指定信息的值
        :param time: 指定的时间戳,若为None,则使用当前bar的时间戳
        :param marker: 数据点类型
        :param line_style: 线型
        :return: None
        """

        if not time:
            time = self.current_datetime
        self._plotKeeper.attach(time, name, value, marker, line_style)

    def infoView(self):
        u"""

        返回当前所保留的全部用户信息

        :return: pandas.DataFrame
        """
        return self._infoKeeper.view()

    def plotCurves(self):
        u"""

        返回当前所保留的全部绘图用信息

        :return: pandas.DataFrame
        """
        return self._plotKeeper.curves()

    @property
    def cash(self):
        u"""

        返回当前账户现金

        :return: float
        """
        return self._port.currentHoldings['cash']

    @property
    def portfolioValue(self):
        u"""

        返回当前账户总净值

        :return: float
        """
        return self._port.allHoldings[-1]['total']

    def avaliableForSale(self, symbol):
        u"""

        返回指定证券当前可卖出数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[0]

    def avaliableForBuyBack(self, symbol):
        u"""

        返回指定证券当前可买回数量

        :param symbol: 证券代码
        :return: int
        """
        return self.avaliableForTrade(symbol)[1]

    def avaliableForTrade(self, symbol):
        u"""

        返回指定证券当前账户可交易数量,返回为一个tuple类型,分别为可卖出数量和可买回数量

        :param symbol: 证券代码
        :return: tuple
        """
        currDTTime = self.current_datetime
        currDT = currDTTime.date()
        return self._posBook.avaliableForTrade(symbol, currDT)

    def _processOrders(self):

        signals = []

        currDTTime = self.current_datetime
        if isinstance(currDTTime, dt.datetime):
            currDT = currDTTime.date()
        else:
            currDT = currDTTime

        cashAmount = self._port.currentHoldings['cash']
        for order in self._orderRecords:
            cashAmount = max(cashAmount, 1.e-5)
            symbol = order['symbol']
            quantity = order['quantity']
            direction = order['direction']
            currValue = self.bars.getLatestBarValue(symbol, 'close')

            multiplier = self._port.assets[symbol].multiplier
            settle = self._port.assets[symbol].settle
            margin = self._port.assets[symbol].margin

            # amount available for buy back or sell
            if direction == OrderDirection.BUY:
                fill_cost = quantity * currValue * multiplier * settle
                margin_cost = 0.
            elif direction == OrderDirection.BUY_BACK:
                fill_cost = 0.
                margin_cost = 0.
            elif direction == OrderDirection.SELL:
                fill_cost = 0.
                margin_cost = 0.
            elif direction == OrderDirection.SELL_SHORT:
                fill_cost = 0.
                margin_cost = quantity * currValue * multiplier * margin

            maximumCashCost = max(fill_cost, margin_cost)

            if maximumCashCost <= cashAmount:
                signal = OrderEvent(currDTTime, symbol, "MKT", quantity, direction)
                self._posBook.updatePositionsByOrder(symbol, currDT, quantity, direction)
                signals.append(signal)
                cashAmount -= maximumCashCost
            elif maximumCashCost > cashAmount:
                if direction == OrderDirection.BUY:
                    self.logger.warning("{0}: ${1} cash needed to buy the quantity {2} of {3} "
                                        "is less than available cash ${4}"
                                        .format(currDTTime, maximumCashCost, quantity, symbol, cashAmount))
                elif direction == OrderDirection.SELL_SHORT:
                    self.logger.warning("{0}: ${1} cash needed to sell short the quantity {2} of {3} "
                                        "is less than available cash ${4}"
                                        .format(currDTTime, maximumCashCost, quantity, symbol, cashAmount))

        # log the signal informations
        for signal in signals:
            self.logger.info("{0}: {1} Order ID: {2} is sent with quantity {3} and direction {4} on symbol {5}"
                             .format(signal.timeIndex,
                                     signal.orderType,
                                     signal.orderID,
                                     signal.quantity,
                                     signal.direction,
                                     signal.symbol))
            self.events.put(signal)

    def order_to(self, symbol, direction, quantity):
        u"""

        交易指定证券至指定要求的仓位

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity: 指定要求的仓位
        :return: None
        """

        if symbol not in self._posTargets:
            currentPos = self.secPos[symbol]
            self._posTargets[symbol] = currentPos
        else:
            currentPos = self._posTargets[symbol]

        if direction == 1:
            posNeedToBuy = quantity - currentPos
            if posNeedToBuy > 0:
                self.order(symbol, 1, posNeedToBuy)
            elif posNeedToBuy < 0:
                self.order(symbol, -1, -posNeedToBuy)
        elif direction == -1:
            posNeedToSell = quantity + currentPos
            if posNeedToSell > 0:
                self.order(symbol, -1, posNeedToSell)
            elif posNeedToSell < 0:
                self.order(symbol, 1, -posNeedToSell)

    def order(self, symbol, direction, quantity):
        u"""

        交易指定量的指定证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param quantity:交易量
        :return: None
        """

        currDTTime = self.current_datetime

        if symbol not in self.tradableAssets:
            self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is rejected since {1}"
                                " is not a tradable asset!".format(currDTTime, symbol, quantity, direction))
            return

        if quantity % self._port.assets[symbol].minimum != 0:
            self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is not consistent "
                                "with minimum bucket amount seeting. "
                                "Order is discarded!".format(currDTTime, symbol, quantity, direction))
            return

        if symbol in self.priceLimitTable:
            currValue = self.bars.getLatestBarValue(symbol, 'close')
            low_limit, high_limit = self.priceLimitTable[symbol]
            if currValue <= low_limit and direction < 0:
                self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is not sent "
                                    "with market is frozen at {4} lower limit price."
                                    .format(currDTTime, symbol, quantity, direction, currValue))
                return
            elif currValue >= high_limit and direction > 0:
                self.logger.warning("{0}: Order for {1} with amount {2} and direction as {3} is not sent "
                                    "with market is frozen at {4} higher limit price."
                                    .format(currDTTime, symbol, quantity, direction, currValue))
                return

        if symbol not in self._posTargets:
            self._posTargets[symbol] = self.secPos[symbol]

        if quantity > 0 and direction == 1:
            self._posTargets[symbol] += quantity
            buyback_amount = self.avaliableForBuyBack(symbol)
            if buyback_amount >= quantity:
                self._orderRecords.append({'symbol': symbol, 'quantity': quantity, 'direction': OrderDirection.BUY_BACK})
            else:
                if buyback_amount != 0:
                    self._orderRecords.append({'symbol': symbol, 'quantity': buyback_amount, 'direction': OrderDirection.BUY_BACK})
                self._orderRecords.append({'symbol': symbol, 'quantity': quantity - buyback_amount, 'direction': OrderDirection.BUY})
        elif quantity > 0 and direction == -1:
            self._posTargets[symbol] -= quantity
            sell_amount = self.avaliableForSale(symbol)
            if sell_amount >= quantity:
                self._orderRecords.append({'symbol': symbol, 'quantity': quantity, 'direction': OrderDirection.SELL})
            else:
                if self._port.assets[symbol].short:
                    if sell_amount != 0:
                        self._orderRecords.append({'symbol': symbol, 'quantity': sell_amount, 'direction': OrderDirection.SELL})
                    self._orderRecords.append({'symbol': symbol, 'quantity': quantity - sell_amount, 'direction': OrderDirection.SELL_SHORT})
                else:
                    self.logger.warning("{0}: short disabled {1} quantity need to be sold {2} "
                                        "is less then the available for sell amount {3}."
                                        .format(currDTTime, symbol, quantity, sell_amount))

        elif quantity == 0 and abs(direction) == 1:
            pass
        elif quantity < 0:
            raise ValueError("quantity cant't be negative as {0}".format(quantity))
        else:
            raise ValueError("Unrecognized direction {0}".format(direction))

    def order_pct(self, symbol, direction, pct):
        u"""

        交易占当前资产组合指定比例的证券

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param pct: 比例
        :return: None
        """
        currDTTime = self.current_datetime
        if pct < 0. or pct > 1.0:
            self.logger.warning("{0:}: Percentage order for {1} with percentage {2} and direction {4} is not allowed. "
                                "Percentage should be between 0 and 1".format(currDTTime, symbol, pct, direction))
            return

        portfolio_value = self.portfolioValue
        currValue = self.bars.getLatestBarValue(symbol, 'close')
        rought_amount = int(portfolio_value * pct / currValue)
        actual_amount = rought_amount // self._port.assets[symbol].minimum * self._port.assets[symbol].minimum
        self.order(symbol, direction, actual_amount)

    def order_to_pct(self, symbol, direction, pct):
        u"""

        交易证券至占当前组合指定比例

        :param symbol: 证券代码
        :param direction: 方向,1为买入,-1为卖出
        :param pct: 目标比例
        :return: None
        """
        currDTTime = self.current_datetime
        if pct < 0. or pct > 1.0:
            self.logger.warning("{0:}: Percentage order for {1} with percentage {2} and direction {4} is not allowed. "
                                "Percentage should be between 0 and 1".format(currDTTime, symbol, pct, direction))
            return

        portfolio_value = self.portfolioValue
        currValue = self.bars.getLatestBarValue(symbol, 'close')
        rought_amount = int(portfolio_value * pct / currValue)
        actual_amount = rought_amount // self._port.assets[symbol].minimum * self._port.assets[symbol].minimum
        self.order_to(symbol, direction, actual_amount)

    @property
    def liveOrders(self):
        return self._port.orderBook.liveOrders()

    def secPosDetail(self, secID):
        try:
            return self._port.positionsBook.positions(secID).view()
        except KeyError:
            return pd.DataFrame()

    @property
    def secPos(self):
        u"""

        保存当前证券整体仓位信息(单位,股数)

        :return: int
        """
        return self._port.currentPosition

    @property
    def holdings(self):
        u"""

        保存当前证券仓位信息(单位,元)

        :return: float
        """
        return self._port.allHoldings[-1]

    @property
    def realizedHoldings(self):
        return self._port.currentHoldings

    def checkingPriceLimit(self):
        self.priceLimitTable = {}
        # only work for securities close at the same time
        for s in self.tradableAssets:
            try:
                previous_day_close = self.bars.getPreviousDayValue(s, 'close')
            except KeyError:
                previous_day_close = np.nan

            if not np.isnan(previous_day_close):
                price_limit = self._port.assets[s].price_limit
                self.priceLimitTable[s] = (1.005 - price_limit) * previous_day_close, (0.995 + price_limit) * previous_day_close,