2021-01-02 14:13:32 +00:00
|
|
|
import logging
|
2020-12-26 19:05:27 +00:00
|
|
|
from copy import deepcopy
|
|
|
|
from pathlib import Path
|
2021-01-02 14:11:40 +00:00
|
|
|
from typing import List, Optional
|
2020-12-26 15:43:15 +00:00
|
|
|
|
2021-12-11 14:53:44 +00:00
|
|
|
from fastapi import APIRouter, Depends, Query
|
2020-12-26 19:05:27 +00:00
|
|
|
from fastapi.exceptions import HTTPException
|
2020-12-24 05:55:19 +00:00
|
|
|
|
2020-12-25 12:11:01 +00:00
|
|
|
from freqtrade import __version__
|
2020-12-27 08:02:35 +00:00
|
|
|
from freqtrade.constants import USERPATH_STRATEGIES
|
2020-12-26 19:05:27 +00:00
|
|
|
from freqtrade.data.history import get_datahandler
|
|
|
|
from freqtrade.exceptions import OperationalException
|
2020-12-26 14:54:22 +00:00
|
|
|
from freqtrade.rpc import RPC
|
2021-04-02 18:00:14 +00:00
|
|
|
from freqtrade.rpc.api_server.api_schemas import (AvailablePairs, Balances, BlacklistPayload,
|
|
|
|
BlacklistResponse, Count, Daily,
|
|
|
|
DeleteLockRequest, DeleteTrade, ForceBuyPayload,
|
2022-01-24 12:09:23 +00:00
|
|
|
ForceBuyResponse, ForceSellPayload, Health, Locks,
|
|
|
|
Logs, OpenTradeSchema, PairHistory,
|
2022-01-23 19:58:46 +00:00
|
|
|
PerformanceEntry, Ping, PlotConfig, Profit,
|
|
|
|
ResultMsg, ShowConfig, Stats, StatusMsg,
|
|
|
|
StrategyListResponse, StrategyResponse, SysInfo,
|
|
|
|
Version, WhitelistResponse)
|
2022-01-22 06:11:59 +00:00
|
|
|
from freqtrade.rpc.api_server.deps import get_config, get_exchange, get_rpc, get_rpc_optional
|
2020-12-26 16:00:30 +00:00
|
|
|
from freqtrade.rpc.rpc import RPCException
|
2020-12-25 12:11:01 +00:00
|
|
|
|
2020-12-24 05:55:19 +00:00
|
|
|
|
2021-01-02 14:13:32 +00:00
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
2021-11-23 06:06:53 +00:00
|
|
|
# API version
|
|
|
|
# Pre-1.1, no version was provided
|
|
|
|
# Version increments should happen in "small" steps (1.1, 1.12, ...) unless big changes happen.
|
2021-11-27 08:10:18 +00:00
|
|
|
# 1.11: forcebuy and forcesell accept ordertype
|
2021-12-11 18:41:30 +00:00
|
|
|
# 1.12: add blacklist delete endpoint
|
2022-01-22 12:26:02 +00:00
|
|
|
# 1.13: forcebuy supports stake_amount
|
2022-02-26 15:10:54 +00:00
|
|
|
# 1.14: Add entry/exit orders to trade response
|
|
|
|
API_VERSION = 1.14
|
2021-11-23 06:06:53 +00:00
|
|
|
|
2020-12-25 12:08:25 +00:00
|
|
|
# Public API, requires no auth.
|
|
|
|
router_public = APIRouter()
|
2020-12-25 12:11:01 +00:00
|
|
|
# Private API, protected by authentication
|
2020-12-24 05:55:19 +00:00
|
|
|
router = APIRouter()
|
|
|
|
|
|
|
|
|
2020-12-25 12:08:25 +00:00
|
|
|
@router_public.get('/ping', response_model=Ping)
|
|
|
|
def ping():
|
2020-12-26 16:48:19 +00:00
|
|
|
"""simple ping"""
|
2020-12-24 05:55:19 +00:00
|
|
|
return {"status": "pong"}
|
|
|
|
|
|
|
|
|
2020-12-25 19:07:12 +00:00
|
|
|
@router.get('/version', response_model=Version, tags=['info'])
|
2020-12-25 14:57:05 +00:00
|
|
|
def version():
|
2020-12-26 16:48:19 +00:00
|
|
|
""" Bot Version info"""
|
2020-12-25 14:57:05 +00:00
|
|
|
return {"version": __version__}
|
|
|
|
|
|
|
|
|
2020-12-25 19:07:12 +00:00
|
|
|
@router.get('/balance', response_model=Balances, tags=['info'])
|
|
|
|
def balance(rpc: RPC = Depends(get_rpc), config=Depends(get_config)):
|
2020-12-26 16:48:19 +00:00
|
|
|
"""Account Balances"""
|
2020-12-25 12:08:25 +00:00
|
|
|
return rpc._rpc_balance(config['stake_currency'], config.get('fiat_display_currency', ''),)
|
2020-12-25 12:11:01 +00:00
|
|
|
|
|
|
|
|
2020-12-26 14:54:22 +00:00
|
|
|
@router.get('/count', response_model=Count, tags=['info'])
|
|
|
|
def count(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_count()
|
|
|
|
|
|
|
|
|
2020-12-26 15:43:15 +00:00
|
|
|
@router.get('/performance', response_model=List[PerformanceEntry], tags=['info'])
|
|
|
|
def performance(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_performance()
|
|
|
|
|
|
|
|
|
|
|
|
@router.get('/profit', response_model=Profit, tags=['info'])
|
|
|
|
def profit(rpc: RPC = Depends(get_rpc), config=Depends(get_config)):
|
|
|
|
return rpc._rpc_trade_statistics(config['stake_currency'],
|
|
|
|
config.get('fiat_display_currency')
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
@router.get('/stats', response_model=Stats, tags=['info'])
|
|
|
|
def stats(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_stats()
|
|
|
|
|
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.get('/daily', response_model=Daily, tags=['info'])
|
|
|
|
def daily(timescale: int = 7, rpc: RPC = Depends(get_rpc), config=Depends(get_config)):
|
|
|
|
return rpc._rpc_daily_profit(timescale, config['stake_currency'],
|
|
|
|
config.get('fiat_display_currency', ''))
|
|
|
|
|
|
|
|
|
2021-01-01 18:38:28 +00:00
|
|
|
@router.get('/status', response_model=List[OpenTradeSchema], tags=['info'])
|
2020-12-26 16:00:30 +00:00
|
|
|
def status(rpc: RPC = Depends(get_rpc)):
|
|
|
|
try:
|
|
|
|
return rpc._rpc_trade_status()
|
|
|
|
except RPCException:
|
|
|
|
return []
|
|
|
|
|
|
|
|
|
2021-04-13 04:23:11 +00:00
|
|
|
# Using the responsemodel here will cause a ~100% increase in response time (from 1s to 2s)
|
|
|
|
# on big databases. Correct response model: response_model=TradeResponse,
|
|
|
|
@router.get('/trades', tags=['info', 'trading'])
|
2021-04-18 14:05:28 +00:00
|
|
|
def trades(limit: int = 500, offset: int = 0, rpc: RPC = Depends(get_rpc)):
|
2021-04-22 04:51:26 +00:00
|
|
|
return rpc._rpc_trade_history(limit, offset=offset, order_by_id=True)
|
2020-12-26 16:33:27 +00:00
|
|
|
|
|
|
|
|
2021-04-05 17:31:34 +00:00
|
|
|
@router.get('/trade/{tradeid}', response_model=OpenTradeSchema, tags=['info', 'trading'])
|
|
|
|
def trade(tradeid: int = 0, rpc: RPC = Depends(get_rpc)):
|
2021-04-16 17:35:56 +00:00
|
|
|
try:
|
|
|
|
return rpc._rpc_trade_status([tradeid])[0]
|
|
|
|
except (RPCException, KeyError):
|
|
|
|
raise HTTPException(status_code=404, detail='Trade not found.')
|
2021-04-05 17:31:34 +00:00
|
|
|
|
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.delete('/trades/{tradeid}', response_model=DeleteTrade, tags=['info', 'trading'])
|
|
|
|
def trades_delete(tradeid: int, rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_delete(tradeid)
|
|
|
|
|
|
|
|
|
|
|
|
# TODO: Missing response model
|
|
|
|
@router.get('/edge', tags=['info'])
|
|
|
|
def edge(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_edge()
|
|
|
|
|
|
|
|
|
2021-01-02 14:48:33 +00:00
|
|
|
@router.get('/show_config', response_model=ShowConfig, tags=['info'])
|
2021-01-02 12:12:49 +00:00
|
|
|
def show_config(rpc: Optional[RPC] = Depends(get_rpc_optional), config=Depends(get_config)):
|
|
|
|
state = ''
|
2021-12-04 13:49:45 +00:00
|
|
|
strategy_version = None
|
2021-01-02 12:12:49 +00:00
|
|
|
if rpc:
|
|
|
|
state = rpc._freqtrade.state
|
2021-12-04 13:49:45 +00:00
|
|
|
strategy_version = rpc._freqtrade.strategy.version()
|
|
|
|
resp = RPC._rpc_show_config(config, state, strategy_version)
|
2021-11-23 06:06:53 +00:00
|
|
|
resp['api_version'] = API_VERSION
|
|
|
|
return resp
|
2020-12-26 14:54:22 +00:00
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
|
2021-01-02 14:11:40 +00:00
|
|
|
@router.post('/forcebuy', response_model=ForceBuyResponse, tags=['trading'])
|
2020-12-26 16:00:30 +00:00
|
|
|
def forcebuy(payload: ForceBuyPayload, rpc: RPC = Depends(get_rpc)):
|
2021-11-27 08:26:14 +00:00
|
|
|
ordertype = payload.ordertype.value if payload.ordertype else None
|
2022-01-22 12:26:02 +00:00
|
|
|
stake_amount = payload.stakeamount if payload.stakeamount else None
|
2022-03-20 08:30:11 +00:00
|
|
|
entry_tag = payload.entry_tag if payload.entry_tag else 'forceentry'
|
2022-01-22 12:26:02 +00:00
|
|
|
|
2022-02-11 14:31:15 +00:00
|
|
|
trade = rpc._rpc_forcebuy(payload.pair, payload.price, ordertype, stake_amount, entry_tag)
|
2020-12-26 16:00:30 +00:00
|
|
|
|
|
|
|
if trade:
|
2021-03-01 06:08:44 +00:00
|
|
|
return ForceBuyResponse.parse_obj(trade.to_json())
|
2020-12-26 16:00:30 +00:00
|
|
|
else:
|
2021-03-01 06:08:44 +00:00
|
|
|
return ForceBuyResponse.parse_obj({"status": f"Error buying pair {payload.pair}."})
|
2020-12-26 16:00:30 +00:00
|
|
|
|
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.post('/forcesell', response_model=ResultMsg, tags=['trading'])
|
2020-12-26 16:00:30 +00:00
|
|
|
def forcesell(payload: ForceSellPayload, rpc: RPC = Depends(get_rpc)):
|
2021-11-27 08:26:14 +00:00
|
|
|
ordertype = payload.ordertype.value if payload.ordertype else None
|
|
|
|
return rpc._rpc_forcesell(payload.tradeid, ordertype)
|
2020-12-26 16:00:30 +00:00
|
|
|
|
2020-12-26 14:54:22 +00:00
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.get('/blacklist', response_model=BlacklistResponse, tags=['info', 'pairlist'])
|
|
|
|
def blacklist(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_blacklist()
|
|
|
|
|
|
|
|
|
|
|
|
@router.post('/blacklist', response_model=BlacklistResponse, tags=['info', 'pairlist'])
|
|
|
|
def blacklist_post(payload: BlacklistPayload, rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_blacklist(payload.blacklist)
|
|
|
|
|
|
|
|
|
2021-12-11 14:53:44 +00:00
|
|
|
@router.delete('/blacklist', response_model=BlacklistResponse, tags=['info', 'pairlist'])
|
|
|
|
def blacklist_delete(pairs_to_delete: List[str] = Query([]), rpc: RPC = Depends(get_rpc)):
|
|
|
|
"""Provide a list of pairs to delete from the blacklist"""
|
|
|
|
|
|
|
|
return rpc._rpc_blacklist_delete(pairs_to_delete)
|
|
|
|
|
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.get('/whitelist', response_model=WhitelistResponse, tags=['info', 'pairlist'])
|
|
|
|
def whitelist(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_whitelist()
|
|
|
|
|
|
|
|
|
2021-03-01 18:50:39 +00:00
|
|
|
@router.get('/locks', response_model=Locks, tags=['info', 'locks'])
|
2020-12-26 16:33:27 +00:00
|
|
|
def locks(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_locks()
|
|
|
|
|
|
|
|
|
2021-03-01 18:50:39 +00:00
|
|
|
@router.delete('/locks/{lockid}', response_model=Locks, tags=['info', 'locks'])
|
|
|
|
def delete_lock(lockid: int, rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_delete_lock(lockid=lockid)
|
|
|
|
|
|
|
|
|
|
|
|
@router.post('/locks/delete', response_model=Locks, tags=['info', 'locks'])
|
|
|
|
def delete_lock_pair(payload: DeleteLockRequest, rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_delete_lock(lockid=payload.lockid, pair=payload.pair)
|
|
|
|
|
|
|
|
|
2020-12-26 16:33:27 +00:00
|
|
|
@router.get('/logs', response_model=Logs, tags=['info'])
|
2021-06-24 16:17:40 +00:00
|
|
|
def logs(limit: Optional[int] = None):
|
|
|
|
return RPC._rpc_get_logs(limit)
|
2020-12-26 16:33:27 +00:00
|
|
|
|
|
|
|
|
2020-12-25 19:07:12 +00:00
|
|
|
@router.post('/start', response_model=StatusMsg, tags=['botcontrol'])
|
|
|
|
def start(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_start()
|
|
|
|
|
|
|
|
|
|
|
|
@router.post('/stop', response_model=StatusMsg, tags=['botcontrol'])
|
|
|
|
def stop(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_stop()
|
2020-12-26 14:54:22 +00:00
|
|
|
|
|
|
|
|
|
|
|
@router.post('/stopbuy', response_model=StatusMsg, tags=['botcontrol'])
|
|
|
|
def stop_buy(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_stopbuy()
|
|
|
|
|
|
|
|
|
|
|
|
@router.post('/reload_config', response_model=StatusMsg, tags=['botcontrol'])
|
|
|
|
def reload_config(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._rpc_reload_config()
|
2020-12-26 19:05:27 +00:00
|
|
|
|
|
|
|
|
2020-12-27 08:02:35 +00:00
|
|
|
@router.get('/pair_candles', response_model=PairHistory, tags=['candle data'])
|
2022-01-29 19:16:58 +00:00
|
|
|
def pair_candles(
|
|
|
|
pair: str, timeframe: str, limit: Optional[int] = None, rpc: RPC = Depends(get_rpc)):
|
2020-12-26 19:05:27 +00:00
|
|
|
return rpc._rpc_analysed_dataframe(pair, timeframe, limit)
|
|
|
|
|
|
|
|
|
2020-12-27 08:02:35 +00:00
|
|
|
@router.get('/pair_history', response_model=PairHistory, tags=['candle data'])
|
2020-12-26 19:05:27 +00:00
|
|
|
def pair_history(pair: str, timeframe: str, timerange: str, strategy: str,
|
2022-01-22 06:11:59 +00:00
|
|
|
config=Depends(get_config), exchange=Depends(get_exchange)):
|
|
|
|
# The initial call to this endpoint can be slow, as it may need to initialize
|
|
|
|
# the exchange class.
|
2020-12-26 19:05:27 +00:00
|
|
|
config = deepcopy(config)
|
|
|
|
config.update({
|
2021-08-06 22:19:36 +00:00
|
|
|
'strategy': strategy,
|
|
|
|
})
|
2022-01-22 06:11:59 +00:00
|
|
|
return RPC._rpc_analysed_history_full(config, pair, timeframe, timerange, exchange)
|
2020-12-26 19:05:27 +00:00
|
|
|
|
|
|
|
|
2021-01-02 14:11:40 +00:00
|
|
|
@router.get('/plot_config', response_model=PlotConfig, tags=['candle data'])
|
2020-12-31 10:01:50 +00:00
|
|
|
def plot_config(rpc: RPC = Depends(get_rpc)):
|
2021-03-01 06:08:44 +00:00
|
|
|
return PlotConfig.parse_obj(rpc._rpc_plot_config())
|
2020-12-26 19:05:27 +00:00
|
|
|
|
|
|
|
|
|
|
|
@router.get('/strategies', response_model=StrategyListResponse, tags=['strategy'])
|
|
|
|
def list_strategies(config=Depends(get_config)):
|
|
|
|
directory = Path(config.get(
|
|
|
|
'strategy_path', config['user_data_dir'] / USERPATH_STRATEGIES))
|
|
|
|
from freqtrade.resolvers.strategy_resolver import StrategyResolver
|
2022-04-23 07:11:50 +00:00
|
|
|
strategies = StrategyResolver.search_all_objects(
|
|
|
|
directory, False, config.get('recursive_strategy_search', False))
|
2020-12-26 19:05:27 +00:00
|
|
|
strategies = sorted(strategies, key=lambda x: x['name'])
|
|
|
|
|
|
|
|
return {'strategies': [x['name'] for x in strategies]}
|
|
|
|
|
|
|
|
|
|
|
|
@router.get('/strategy/{strategy}', response_model=StrategyResponse, tags=['strategy'])
|
2021-01-02 14:11:40 +00:00
|
|
|
def get_strategy(strategy: str, config=Depends(get_config)):
|
2020-12-26 19:05:27 +00:00
|
|
|
|
2021-08-14 14:02:12 +00:00
|
|
|
config_ = deepcopy(config)
|
2020-12-26 19:05:27 +00:00
|
|
|
from freqtrade.resolvers.strategy_resolver import StrategyResolver
|
|
|
|
try:
|
2021-08-14 14:02:12 +00:00
|
|
|
strategy_obj = StrategyResolver._load_strategy(strategy, config_,
|
|
|
|
extra_dir=config_.get('strategy_path'))
|
2020-12-26 19:05:27 +00:00
|
|
|
except OperationalException:
|
|
|
|
raise HTTPException(status_code=404, detail='Strategy not found')
|
|
|
|
|
|
|
|
return {
|
|
|
|
'strategy': strategy_obj.get_strategy_name(),
|
|
|
|
'code': strategy_obj.__source__,
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
@router.get('/available_pairs', response_model=AvailablePairs, tags=['candle data'])
|
|
|
|
def list_available_pairs(timeframe: Optional[str] = None, stake_currency: Optional[str] = None,
|
|
|
|
config=Depends(get_config)):
|
|
|
|
|
|
|
|
dh = get_datahandler(config['datadir'], config.get('dataformat_ohlcv', None))
|
|
|
|
|
|
|
|
pair_interval = dh.ohlcv_get_available_data(config['datadir'])
|
|
|
|
|
|
|
|
if timeframe:
|
|
|
|
pair_interval = [pair for pair in pair_interval if pair[1] == timeframe]
|
|
|
|
if stake_currency:
|
|
|
|
pair_interval = [pair for pair in pair_interval if pair[0].endswith(stake_currency)]
|
|
|
|
pair_interval = sorted(pair_interval, key=lambda x: x[0])
|
|
|
|
|
|
|
|
pairs = list({x[0] for x in pair_interval})
|
2021-05-24 05:47:38 +00:00
|
|
|
pairs.sort()
|
2020-12-26 19:05:27 +00:00
|
|
|
result = {
|
|
|
|
'length': len(pairs),
|
|
|
|
'pairs': pairs,
|
|
|
|
'pair_interval': pair_interval,
|
|
|
|
}
|
|
|
|
return result
|
2021-09-25 14:48:42 +00:00
|
|
|
|
2021-10-06 17:36:28 +00:00
|
|
|
|
2021-10-04 23:10:39 +00:00
|
|
|
@router.get('/sysinfo', response_model=SysInfo, tags=['info'])
|
|
|
|
def sysinfo():
|
|
|
|
return RPC._rpc_sysinfo()
|
2022-01-23 19:58:46 +00:00
|
|
|
|
|
|
|
|
|
|
|
@router.get('/health', response_model=Health, tags=['info'])
|
|
|
|
def health(rpc: RPC = Depends(get_rpc)):
|
|
|
|
return rpc._health()
|