-
Notifications
You must be signed in to change notification settings - Fork 1.6k
/
api_stock.py
729 lines (624 loc) · 34.5 KB
/
api_stock.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
# -*- coding: utf-8 -*-
# 版权所有 2019 深圳米筐科技有限公司(下称“米筐科技”)
#
# 除非遵守当前许可,否则不得使用本软件。
#
# * 非商业用途(非商业用途指个人出于非商业目的使用本软件,或者高校、研究所等非营利机构出于教育、科研等目的使用本软件):
# 遵守 Apache License 2.0(下称“Apache 2.0 许可”),
# 您可以在以下位置获得 Apache 2.0 许可的副本:http://www.apache.org/licenses/LICENSE-2.0。
# 除非法律有要求或以书面形式达成协议,否则本软件分发时需保持当前许可“原样”不变,且不得附加任何条件。
#
# * 商业用途(商业用途指个人出于任何商业目的使用本软件,或者法人或其他组织出于任何目的使用本软件):
# 未经米筐科技授权,任何个人不得出于任何商业目的使用本软件(包括但不限于向第三方提供、销售、出租、出借、转让本软件、
# 本软件的衍生产品、引用或借鉴了本软件功能或源代码的产品或服务),任何法人或其他组织不得出于任何目的使用本软件,
# 否则米筐科技有权追究相应的知识产权侵权责任。
# 在此前提下,对本软件的使用同样需要遵守 Apache 2.0 许可,Apache 2.0 许可与本许可冲突之处,以本许可为准。
# 详细的授权流程,请联系 public@ricequant.com 获取。
import datetime
from decimal import Decimal, getcontext
from itertools import chain
from typing import Dict, List, Optional, Union, Tuple
import numpy as np
import pandas as pd
from rqalpha.api import export_as_api
from rqalpha.apis.api_abstract import (order, order_percent, order_shares,
order_target_percent,
order_target_value, order_to,
order_value,
common_rules, TUPLE_PRICE_OR_STYLE_TYPE, PRICE_OR_STYLE_TYPE)
from rqalpha.apis.api_base import (assure_instrument, assure_order_book_id,
cal_style, calc_open_close_style)
from rqalpha.const import (DEFAULT_ACCOUNT_TYPE, EXECUTION_PHASE,
INSTRUMENT_TYPE, ORDER_TYPE, POSITION_DIRECTION,
POSITION_EFFECT, SIDE)
from rqalpha.core.execution_context import ExecutionContext
from rqalpha.core.events import Event, EVENT
from rqalpha.environment import Environment
from rqalpha.mod.rqalpha_mod_sys_risk.validators.cash_validator import \
is_cash_enough
from rqalpha.model.instrument import IndustryCode as industry_code
from rqalpha.model.instrument import IndustryCodeItem, Instrument
from rqalpha.model.instrument import SectorCode as sector_code
from rqalpha.model.instrument import SectorCodeItem
from rqalpha.model.order import LimitOrder, MarketOrder, Order, OrderStyle, ALGO_ORDER_STYLES
from rqalpha.utils import INST_TYPE_IN_STOCK_ACCOUNT, is_valid_price
from rqalpha.utils.arg_checker import apply_rules, verify_that
from rqalpha.utils.datetime_func import to_date
from rqalpha.utils.exception import RQInvalidArgument
from rqalpha.utils.i18n import gettext as _
from rqalpha.utils.logger import user_system_log
# 使用Decimal 解决浮点数运算精度问题
getcontext().prec = 10
export_as_api(industry_code, name='industry_code')
export_as_api(sector_code, name='sector_code')
KSH_MIN_AMOUNT = 200
def _get_account_position_ins(id_or_ins):
ins = assure_instrument(id_or_ins)
try:
account = Environment.get_instance().portfolio.accounts[DEFAULT_ACCOUNT_TYPE.STOCK]
except KeyError:
raise KeyError(_(
u"order_book_id: {order_book_id} needs stock account, please set and try again!"
).format(order_book_id=ins.order_book_id))
position = account.get_position(ins.order_book_id, POSITION_DIRECTION.LONG)
return account, position, ins
def _round_order_quantity(ins, quantity) -> int:
if ins.type == "CS" and ins.board_type == "KSH":
# KSH can buy(sell) 201, 202 shares
return 0 if abs(quantity) < KSH_MIN_AMOUNT else int(quantity)
else:
round_lot = ins.round_lot
try:
return int(Decimal(quantity) / Decimal(round_lot)) * round_lot
except ValueError:
raise
def _get_order_style_price(order_book_id, style):
if isinstance(style, LimitOrder):
return style.get_limit_price()
env = Environment.get_instance()
if isinstance(style, MarketOrder):
return env.data_proxy.get_last_price(order_book_id)
if isinstance(style, ALGO_ORDER_STYLES):
price, _ = env.data_proxy.get_algo_bar(order_book_id, style, env.calendar_dt)
return price
raise RuntimeError(f"no support {style} order style")
def _submit_order(ins, amount, side, position_effect, style, current_quantity, auto_switch_order_value):
env = Environment.get_instance()
if isinstance(style, LimitOrder) and np.isnan(style.get_limit_price()):
raise RQInvalidArgument(_(u"Limit order price should not be nan."))
price = env.data_proxy.get_last_price(ins.order_book_id)
if not is_valid_price(price):
reason = _(u"Order Creation Failed: [{order_book_id}] No market data").format(order_book_id=ins.order_book_id)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=ins.order_book_id, order=None, reason=reason))
return
if (side == SIDE.BUY and current_quantity != -amount) or (side == SIDE.SELL and current_quantity != abs(amount)):
# 在融券回测中,需要用买单作为平空,对于此种情况下出现的碎股,亦允许一次性申报卖出
amount = _round_order_quantity(ins, amount)
if amount == 0:
reason = _(u"Order Creation Failed: 0 order quantity, order_book_id={order_book_id}").format(order_book_id=ins.order_book_id)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=ins.order_book_id, order=None, reason=reason))
return
order = Order.__from_create__(ins.order_book_id, abs(amount), side, style, position_effect)
if side == SIDE.BUY and auto_switch_order_value:
account, position, ins = _get_account_position_ins(ins)
if not is_cash_enough(env, order, account.cash):
user_system_log.warn(_(
"insufficient cash, use all remaining cash({}) to create order"
).format(account.cash))
return _order_value(account, position, ins, account.cash, style)
return env.submit_order(order)
def _order_shares(ins, amount, style, quantity, auto_switch_order_value):
side, position_effect = (SIDE.BUY, POSITION_EFFECT.OPEN) if amount > 0 else (SIDE.SELL, POSITION_EFFECT.CLOSE)
return _submit_order(ins, amount, side, position_effect, style, quantity, auto_switch_order_value)
def _order_value(account, position, ins, cash_amount, style):
env = Environment.get_instance()
if cash_amount > 0:
cash_amount = min(cash_amount, account.cash)
if isinstance(style, LimitOrder):
price = style.get_limit_price()
else:
price = env.data_proxy.get_last_price(ins.order_book_id)
if not is_valid_price(price):
reason = _(u"Order Creation Failed: [{order_book_id}] No market data").format(order_book_id=ins.order_book_id)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=ins.order_book_id, order=None, reason=reason))
return
amount = int(Decimal(cash_amount) / Decimal(price))
round_lot = int(ins.round_lot)
if cash_amount > 0:
amount = _round_order_quantity(ins, amount)
while amount > 0:
expected_transaction_cost = env.get_order_transaction_cost(Order.__from_create__(
ins.order_book_id, amount, SIDE.BUY, LimitOrder(price), POSITION_EFFECT.OPEN
))
if amount * price + expected_transaction_cost <= cash_amount:
break
amount -= round_lot
else:
reason = _(u"Order Creation Failed: 0 order quantity, order_book_id={order_book_id}").format(order_book_id=ins.order_book_id)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=ins.order_book_id, order=None, reason=reason))
return
if amount < 0:
amount = max(amount, -position.closable)
return _order_shares(ins, amount, style, position.quantity, auto_switch_order_value=False)
@order_shares.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_shares(id_or_ins, amount, price_or_style=None, price=None, style=None):
auto_switch_order_value = Environment.get_instance().config.mod.sys_accounts.auto_switch_order_value
account, position, ins = _get_account_position_ins(id_or_ins)
return _order_shares(
assure_instrument(id_or_ins), amount, cal_style(price, style, price_or_style), position.quantity,
auto_switch_order_value
)
@order_value.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_value(id_or_ins, cash_amount, price_or_style=None, price=None, style=None):
account, position, ins = _get_account_position_ins(id_or_ins)
return _order_value(account, position, ins, cash_amount, cal_style(price, style, price_or_style))
@order_percent.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_percent(id_or_ins, percent, price_or_style=None, price=None, style=None):
account, position, ins = _get_account_position_ins(id_or_ins)
return _order_value(account, position, ins, account.total_value * percent, cal_style(price, style, price_or_style))
@order_target_value.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_target_value(id_or_ins, cash_amount, price_or_style=None, price=None, style=None):
account, position, ins = _get_account_position_ins(id_or_ins)
open_style, close_style = calc_open_close_style(price, style, price_or_style)
if cash_amount == 0:
return _submit_order(
ins, position.closable, SIDE.SELL, POSITION_EFFECT.CLOSE, close_style, position.quantity, False
)
_delta = cash_amount - position.market_value
_style = open_style if _delta > 0 else close_style
return _order_value(account, position, ins, _delta, _style)
@order_target_percent.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_target_percent(id_or_ins, percent, price_or_style=None, price=None, style=None):
account, position, ins = _get_account_position_ins(id_or_ins)
open_style, close_style = calc_open_close_style(price, style, price_or_style)
if percent == 0:
return _submit_order(
ins, position.closable, SIDE.SELL, POSITION_EFFECT.CLOSE, close_style, position.quantity, False
)
_delta = account.total_value * percent - position.market_value
_style = open_style if _delta > 0 else close_style
return _order_value(account, position, ins, _delta, _style)
@order.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order(order_book_id, quantity, price_or_style=None, price=None, style=None):
result_order = stock_order_shares(order_book_id, quantity, price, style, price_or_style)
if result_order:
return [result_order]
return []
@order_to.register(INST_TYPE_IN_STOCK_ACCOUNT)
def stock_order_to(order_book_id, quantity, price_or_style=None, price=None, style=None):
position = Environment.get_instance().portfolio.get_position(order_book_id, POSITION_DIRECTION.LONG)
open_style, close_style = calc_open_close_style(price, style, price_or_style)
quantity = quantity - position.quantity
_style = open_style if quantity > 0 else close_style
result_order = stock_order_shares(order_book_id, quantity, price, _style, price_or_style)
if result_order:
return [result_order]
return []
@export_as_api
@ExecutionContext.enforce_phase(
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.SCHEDULED,
EXECUTION_PHASE.GLOBAL
)
@apply_rules(verify_that('id_or_ins').is_valid_stock(), verify_that('amount').is_number(), *common_rules)
def order_lots(id_or_ins, amount, price_or_style=None, price=None, style=None):
# type: (Union[str, Instrument], int, PRICE_OR_STYLE_TYPE, Optional[float], Optional[OrderStyle]) -> Optional[Order]
"""
指定手数发送买/卖单。如有需要落单类型当做一个参量传入,如果忽略掉落单类型,那么默认是市价单(market order)。
:param id_or_ins: 下单标的物
:param int amount: 下单量, 正数代表买入,负数代表卖出。将会根据一手xx股来向下调整到一手的倍数,比如中国A股就是调整成100股的倍数。
:param price_or_style: 默认为None,表示市价单,可设置价格,表示限价单,也可以直接设置订单类型,有如下选项:MarketOrder、LimitOrder、
TWAPOrder、VWAPOrder
:example:
.. code-block:: python
#买入20手的平安银行股票,并且发送市价单:
order_lots('000001.XSHE', 20)
#买入10手平安银行股票,并且发送限价单,价格为¥10:
order_lots('000001.XSHE', 10, price_or_style=LimitOrder(10))
"""
auto_switch_order_value = Environment.get_instance().config.mod.sys_accounts.auto_switch_order_value
account, position, ins = _get_account_position_ins(id_or_ins)
return _order_shares(
ins, amount * int(ins.round_lot), cal_style(price, style, price_or_style), position.quantity,
auto_switch_order_value
)
ORDER_TARGET_PORTFOLIO_SUPPORTED_INS_TYPES = {
INSTRUMENT_TYPE.CS, INSTRUMENT_TYPE.ETF, INSTRUMENT_TYPE.LOF, INSTRUMENT_TYPE.INDX, INSTRUMENT_TYPE.CONVERTIBLE
}
@export_as_api
@ExecutionContext.enforce_phase(
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.SCHEDULED,
EXECUTION_PHASE.GLOBAL
)
def order_target_portfolio(
target_portfolio: Dict[str, float], price_or_styles: Dict[str, TUPLE_PRICE_OR_STYLE_TYPE] = dict({}),
) -> List[Order]:
"""
批量调整股票仓位至目标权重。注意:股票账户中未出现在 target_portfolio 中的资产将被平仓!
该 API 的参数 target_portfolio 为字典,key 为 order_book_id 或 instrument,value 为权重。
此时将根据参数 price_or_styles 中设置的价格来计算目标持仓数量并调仓。
:param target_portfolio: 目标权重字典,key 为 order_book_id,value 为权重。
:param price_or_styles: 目标下单价格字典,key 为 order_book_id, value 为价格或订单类型或订单类型和价格组成的 tuple
:example:
.. code-block:: python
# 调整仓位,以使平安银行和万科 A 的持仓占比分别达到 10% 和 15%, 同时发送市价单
order_target_portfolio({
'000001.XSHE': 0.1,
'000002.XSHE': 0.15
})
# 调整仓位,分别以 14 和 26 元发出限价单,目标是使平安银行和万科 A 的持仓占比分别达到 10% 和 15%
order_target_portfolio({
'000001.XSHE': 0.1,
'000002.XSHE': 0.15
}, {
'000001.XSHE': 14,
'000002.XSHE': 26,
})
# 调整仓位,使平安银行和万科 A 的持仓占比分别达到 10% 和 15%。
# 其中平安银行的平仓价为 14 元,开仓价为 15 元;万科 A 的平仓价为 26 元,开仓价为 27 元。
order_target_portfolio({
'000001.XSHE': 0.1,
'000002.XSHE': 0.15
}, {
'000001.XSHE': (15, 14),
'000002.XSHE': (27, 26)
})
"""
env = Environment.get_instance()
target: Dict[str, Tuple[float, float, float, float]] = {}
for id_or_ins, percent in target_portfolio.items():
ins = assure_instrument(id_or_ins)
if not ins:
raise RQInvalidArgument(_(
"function order_target_portfolio: invalid keys of target_portfolio, "
"expected order_book_ids or Instrument objects, got {} (type: {})"
).format(id_or_ins, type(id_or_ins)))
if ins.type not in ORDER_TARGET_PORTFOLIO_SUPPORTED_INS_TYPES:
raise RQInvalidArgument(_(
"function order_target_portfolio: invalid instrument type, excepted CS/ETF/LOF/INDX, got {}"
).format(ins.order_book_id))
order_book_id = ins.order_book_id
last_price = env.data_proxy.get_last_price(order_book_id)
if not is_valid_price(last_price):
reason = _(u"Order Creation Failed: [{order_book_id}] No market data").format(order_book_id=order_book_id)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=ins.order_book_id, order=None, reason=reason))
continue
price_or_style = price_or_styles.get(ins.order_book_id)
open_style, close_style = calc_open_close_style(price=None, style=None, price_or_style=price_or_style)
if percent < 0:
raise RQInvalidArgument(_(
"function order_target_portfolio: invalid values of target_portfolio, "
"excepted float between 0 and 1, got {} (key: {})"
).format(percent, id_or_ins))
target[order_book_id] = percent, open_style, close_style, last_price
total_percent = sum(p for p, *__ in target.values())
if total_percent > 1 and not np.isclose(total_percent, 1):
raise RQInvalidArgument(_("total percent should be lower than 1, current: {}").format(total_percent))
account = env.portfolio.accounts[DEFAULT_ACCOUNT_TYPE.STOCK]
# 先把不在目标权重中的仓位平掉
current_quantities = {
p.order_book_id: p.quantity for p in account.get_positions() if p.direction == POSITION_DIRECTION.LONG
}
for order_book_id, quantity in current_quantities.items():
if order_book_id not in target:
env.submit_order(Order.__from_create__(
order_book_id, quantity, SIDE.SELL, MarketOrder(), POSITION_EFFECT.CLOSE
))
account_value = account.total_value
close_orders, open_orders = [], []
for order_book_id, (target_percent, open_style, close_style, last_price) in target.items():
open_price = _get_order_style_price(order_book_id, open_style)
close_price = _get_order_style_price(order_book_id, close_style)
if not (is_valid_price(close_price) and is_valid_price(open_price)):
reason = _("Adjust position of {id_or_ins} Failed: Invalid close/open price {close_price}/{open_price}").format(
id_or_ins=order_book_id, close_price=close_price, open_price=open_price
)
user_system_log.warn(reason)
env.event_bus.publish_event(Event(EVENT.ORDER_CREATION_REJECT, order_book_id=order_book_id, order=None, reason=reason))
continue
delta_quantity = (account_value * target_percent / close_price) - current_quantities.get(order_book_id, 0)
delta_quantity = _round_order_quantity(env.data_proxy.instrument(order_book_id), delta_quantity)
if delta_quantity == 0:
continue
elif delta_quantity > 0:
quantity, side, position_effect = delta_quantity, SIDE.BUY, POSITION_EFFECT.OPEN
order_list = open_orders
target_style = open_style
else:
quantity, side, position_effect = abs(delta_quantity), SIDE.SELL, POSITION_EFFECT.CLOSE
order_list = close_orders
target_style = close_style
order = Order.__from_create__(order_book_id, quantity, side, target_style, position_effect)
if isinstance(target_style, MarketOrder):
order.set_frozen_price(last_price)
order_list.append(order)
return list(env.submit_order(o) for o in chain(close_orders, open_orders))
@export_as_api
@ExecutionContext.enforce_phase(EXECUTION_PHASE.ON_INIT,
EXECUTION_PHASE.BEFORE_TRADING,
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.AFTER_TRADING,
EXECUTION_PHASE.SCHEDULED)
@apply_rules(verify_that('order_book_id').is_valid_instrument(),
verify_that('count').is_greater_than(0))
def is_suspended(order_book_id, count=1):
# type: (str, Optional[int]) -> Union[bool, pd.DataFrame]
"""
判断某只股票是否全天停牌。
:param order_book_id: 某只股票的代码或股票代码,可传入单只股票的order_book_id, symbol
:param count: 回溯获取的数据个数。默认为当前能够获取到的最近的数据
"""
dt = Environment.get_instance().calendar_dt.date()
order_book_id = assure_order_book_id(order_book_id)
return Environment.get_instance().data_proxy.is_suspended(order_book_id, dt, count)
@export_as_api
@ExecutionContext.enforce_phase(EXECUTION_PHASE.ON_INIT,
EXECUTION_PHASE.BEFORE_TRADING,
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.AFTER_TRADING,
EXECUTION_PHASE.SCHEDULED)
@apply_rules(verify_that('order_book_id').is_valid_instrument())
def is_st_stock(order_book_id, count=1):
# type: (str, Optional[int]) -> Union[bool, pd.DataFrame]
"""
判断股票在一段时间内是否为ST股(包括ST与*ST)。
ST股是有退市风险因此风险比较大的股票,很多时候您也会希望判断自己使用的股票是否是'ST'股来避开这些风险大的股票。另外,我们目前的策略比赛也禁止了使用'ST'股。
:param order_book_id: 某只股票的代码,可传入单只股票的order_book_id, symbol
:param count: 回溯获取的数据个数。默认为当前能够获取到的最近的数据
"""
dt = Environment.get_instance().calendar_dt.date()
order_book_id = assure_order_book_id(order_book_id)
return Environment.get_instance().data_proxy.is_st_stock(order_book_id, dt, count)
@export_as_api
@ExecutionContext.enforce_phase(
EXECUTION_PHASE.ON_INIT,
EXECUTION_PHASE.BEFORE_TRADING,
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.AFTER_TRADING,
EXECUTION_PHASE.SCHEDULED,
)
@apply_rules(verify_that("code").is_instance_of((str, IndustryCodeItem)))
def industry(code):
# type: (str) -> List[str]
"""
获得属于某一行业的所有股票列表。
:param code: 行业名称或行业代码。例如,农业可填写industry_code.A01 或 'A01'
我们目前使用的行业分类来自于中国国家统计局的 `国民经济行业分类 <http://www.stats.gov.cn/tjsj/tjbz/hyflbz/>`_ ,可以使用这里的任何一个行业代码来调用行业的股票列表:
========================= ===================================================
行业代码 行业名称
========================= ===================================================
A01 农业
A02 林业
A03 畜牧业
A04 渔业
A05 农、林、牧、渔服务业
B06 煤炭开采和洗选业
B07 石油和天然气开采业
B08 黑色金属矿采选业
B09 有色金属矿采选业
B10 非金属矿采选业
B11 开采辅助活动
B12 其他采矿业
C13 农副食品加工业
C14 食品制造业
C15 酒、饮料和精制茶制造业
C16 烟草制品业
C17 纺织业
C18 纺织服装、服饰业
C19 皮革、毛皮、羽毛及其制品和制鞋业
C20 木材加工及木、竹、藤、棕、草制品业
C21 家具制造业
C22 造纸及纸制品业
C23 印刷和记录媒介复制业
C24 文教、工美、体育和娱乐用品制造业
C25 石油加工、炼焦及核燃料加工业
C26 化学原料及化学制品制造业
C27 医药制造业
C28 化学纤维制造业
C29 橡胶和塑料制品业
C30 非金属矿物制品业
C31 黑色金属冶炼及压延加工业
C32 有色金属冶炼和压延加工业
C33 金属制品业
C34 通用设备制造业
C35 专用设备制造业
C36 汽车制造业
C37 铁路、船舶、航空航天和其它运输设备制造业
C38 电气机械及器材制造业
C39 计算机、通信和其他电子设备制造业
C40 仪器仪表制造业
C41 其他制造业
C42 废弃资源综合利用业
C43 金属制品、机械和设备修理业
D44 电力、热力生产和供应业
D45 燃气生产和供应业
D46 水的生产和供应业
E47 房屋建筑业
E48 土木工程建筑业
E49 建筑安装业
E50 建筑装饰和其他建筑业
F51 批发业
F52 零售业
G53 铁路运输业
G54 道路运输业
G55 水上运输业
G56 航空运输业
G57 管道运输业
G58 装卸搬运和运输代理业
G59 仓储业
G60 邮政业
H61 住宿业
H62 餐饮业
I63 电信、广播电视和卫星传输服务
I64 互联网和相关服务
I65 软件和信息技术服务业
J66 货币金融服务
J67 资本市场服务
J68 保险业
J69 其他金融业
K70 房地产业
L71 租赁业
L72 商务服务业
M73 研究和试验发展
M74 专业技术服务业
M75 科技推广和应用服务业
N76 水利管理业
N77 生态保护和环境治理业
N78 公共设施管理业
O79 居民服务业
O80 机动车、电子产品和日用产品修理业
O81 其他服务业
P82 教育
Q83 卫生
Q84 社会工作
R85 新闻和出版业
R86 广播、电视、电影和影视录音制作业
R87 文化艺术业
R88 体育
R89 娱乐业
S90 综合
========================= ===================================================
:example:
.. code-block:: python3
:linenos:
def init(context):
stock_list = industry('A01')
logger.info("农业股票列表:" + str(stock_list))
#INITINFO 农业股票列表:['600354.XSHG', '601118.XSHG', '002772.XSHE', '600371.XSHG', '600313.XSHG', '600672.XSHG', '600359.XSHG', '300143.XSHE', '002041.XSHE', '600762.XSHG', '600540.XSHG', '300189.XSHE', '600108.XSHG', '300087.XSHE', '600598.XSHG', '000998.XSHE', '600506.XSHG']
"""
if isinstance(code, IndustryCodeItem):
code = code.code
else:
code = to_industry_code(code)
cs_instruments = Environment.get_instance().data_proxy.all_instruments((INSTRUMENT_TYPE.CS, ))
return [i.order_book_id for i in cs_instruments if i.industry_code == code]
@export_as_api
@ExecutionContext.enforce_phase(
EXECUTION_PHASE.ON_INIT,
EXECUTION_PHASE.BEFORE_TRADING,
EXECUTION_PHASE.OPEN_AUCTION,
EXECUTION_PHASE.ON_BAR,
EXECUTION_PHASE.ON_TICK,
EXECUTION_PHASE.AFTER_TRADING,
EXECUTION_PHASE.SCHEDULED,
)
@apply_rules(verify_that("code").is_instance_of((str, SectorCodeItem)))
def sector(code):
# type: (str) -> List[str]
"""
获得属于某一板块的所有股票列表。
:param code: 板块名称或板块代码。例如,能源板块可填写'Energy'、'能源'或sector_code.Energy
目前支持的板块分类如下,其取值参考自MSCI发布的全球行业标准分类:
========================= ========================= ==============================================================================
板块代码 中文板块名称 英文板块名称
========================= ========================= ==============================================================================
Energy 能源 energy
Materials 原材料 materials
ConsumerDiscretionary 非必需消费品 consumer discretionary
ConsumerStaples 必需消费品 consumer staples
HealthCare 医疗保健 health care
Financials 金融 financials
InformationTechnology 信息技术 information technology
TelecommunicationServices 电信服务 telecommunication services
Utilities 公共服务 utilities
Industrials 工业 industrials
========================= ========================= ==============================================================================
:example:
.. code-block:: python3
:linenos:
def init(context):
ids1 = sector("consumer discretionary")
ids2 = sector("非必需消费品")
ids3 = sector("ConsumerDiscretionary")
assert ids1 == ids2 and ids1 == ids3
logger.info(ids1)
#INIT INFO
#['002045.XSHE', '603099.XSHG', '002486.XSHE', '002536.XSHE', '300100.XSHE', '600633.XSHG', '002291.XSHE', ..., '600233.XSHG']
"""
if isinstance(code, SectorCodeItem):
code = code.name
else:
code = to_sector_name(code)
cs_instruments = Environment.get_instance().data_proxy.all_instruments((INSTRUMENT_TYPE.CS,))
return [i.order_book_id for i in cs_instruments if i.sector_code == code]
@export_as_api
@apply_rules(
verify_that("order_book_id").is_valid_instrument(),
verify_that("start_date").is_valid_date(ignore_none=False),
)
def get_dividend(order_book_id, start_date):
# type: (str, Union[str, datetime.date, datetime.datetime, pd.Timestamp]) -> Optional[np.ndarray]
"""
获取某只股票到策略当前日期前一天的分红情况(包含起止日期)。
:param order_book_id: 股票代码
:param start_date: 开始日期,需要早于策略当前日期
========================= ===================================================
fields 字段名
========================= ===================================================
announcement_date 分红宣布日
book_closure_date 股权登记日
dividend_cash_before_tax 税前分红
ex_dividend_date 除权除息日
payable_date 分红到帐日
round_lot 分红最小单位
========================= ===================================================
:example:
获取平安银行2013-01-04 到策略当前日期前一天的分红数据:
.. code-block:: python3
:linenos:
get_dividend('000001.XSHE', start_date='20130104')
#[Out]
#array([(20130614, 20130619, 20130620, 20130620, 1.7 , 10),
# (20140606, 20140611, 20140612, 20140612, 1.6 , 10),
# (20150407, 20150410, 20150413, 20150413, 1.74, 10),
# (20160608, 20160615, 20160616, 20160616, 1.53, 10)],
# dtype=[('announcement_date', '<u4'), ('book_closure_date', '<u4'), ('ex_dividend_date', '<u4'), ('payable_date', '<u4'), ('dividend_cash_before_tax', '<f8'), ('round_lot', '<u4')])
"""
# adjusted 参数在不复权数据回测时不再提供
env = Environment.get_instance()
dt = env.trading_dt.date() - datetime.timedelta(days=1)
start_date = to_date(start_date)
if start_date > dt:
raise RQInvalidArgument(
_(
u"in get_dividend, start_date {} is later than the previous test day {}"
).format(start_date, dt)
)
order_book_id = assure_order_book_id(order_book_id)
array = env.data_proxy.get_dividend(order_book_id)
if array is None:
return None
sd = start_date.year * 10000 + start_date.month * 100 + start_date.day
ed = dt.year * 10000 + dt.month * 100 + dt.day
return array[
(array["announcement_date"] >= sd) & (array["announcement_date"] <= ed)
]
def to_industry_code(s):
for __, v in industry_code.__dict__.items():
if isinstance(v, IndustryCodeItem):
if v.name == s:
return v.code
return s
def to_sector_name(s):
for __, v in sector_code.__dict__.items():
if isinstance(v, SectorCodeItem):
if v.cn == s or v.en == s or v.name == s:
return v.name
# not found
return s