交易对象¶

交易¶

Freqtrade 建立的持仓会被存储在 Trade 对象中，并持久化到数据库。这是 freqtrade 的核心概念之一，在文档的许多部分都会提到，通常会引导你来到此处。

该对象会在多个 策略回调函数 中传递给策略。传递给策略的对象不能直接修改，但可能会根据回调结果产生间接修改。

交易 - 可用属性¶

以下属性/特性可用于每个单独的交易，可通过 trade.<property> 的形式访问（例如 trade.pair）。

类方法¶

以下是类方法 —— 它们返回通用信息，通常会触发对数据库的显式查询。可以使用 Trade.<方法名> 的形式调用，例如：open_trades = Trade.get_open_trade_count()

get_trades_proxy¶

当你的策略需要获取有关现有交易（无论是开仓还是已平仓）的信息时，最好使用 Trade.get_trades_proxy()。

用法：

from freqtrade.persistence import Trade
from datetime import timedelta

# ...
trade_hist = Trade.get_trades_proxy(pair='ETH/USDT', is_open=False, open_date=current_date - timedelta(days=2))

get_trades_proxy() 支持以下关键字参数。所有参数均为可选，调用 get_trades_proxy() 时不带参数将返回数据库中所有交易的列表。

• pair，例如：pair='ETH/USDT'
• is_open，例如：is_open=False
• open_date，例如：open_date=current_date - timedelta(days=2)
• close_date，例如：close_date=current_date - timedelta(days=5)

get_open_trade_count¶

获取当前处于开仓状态的交易数量

from freqtrade.persistence import Trade
# ...
open_trades = Trade.get_open_trade_count()

get_total_closed_profit¶

获取机器人至今为止的总盈利。该方法会汇总所有已平仓交易的 close_profit_abs 值。

from freqtrade.persistence import Trade

# ...
profit = Trade.get_total_closed_profit()

total_open_trades_stakes¶

获取当前所有交易中投入的总 stake_amount（投注金额）。

from freqtrade.persistence import Trade

# ...
profit = Trade.total_open_trades_stakes()

get_overall_performance¶

获取整体表现情况 —— 类似于 /performance 电报命令。

from freqtrade.persistence import Trade

# ...
if self.config['runmode'].value in ('live', 'dry_run'):
    performance = Trade.get_overall_performance()

返回示例值：ETH/BTC 共进行了 5 次交易，总利润为 1.5%（即 0.015 的比率）。

{"pair": "ETH/BTC", "profit": 0.015, "count": 5}

订单对象¶

Order 对象表示交易所上的一个订单（或在模拟模式下的虚拟订单）。每个 Order 对象始终与其对应的 Trade 相关联，仅在交易上下文中才有意义。

订单 - 可用属性¶

一个 Order 对象通常与一笔交易相关联。此处大多数属性可能为 None，因为它们取决于交易所的响应。