NautilusTrader Docs · ภาษาไทย

Futures Spread

FuturesSpread แทน futures strategy ที่ exchange กำหนดขึ้นและมีมากกว่าหนึ่ง leg เช่น calendar spread หรือ inter-commodity spread โดย venue เป็นผู้กำหนด strategy, symbol, tick size และวันหมดอายุ

ตัวอย่างได้แก่ futures calendar spread ที่จดทะเบียนซื้อขาย และตลาด spread ที่ exchange รองรับ

ฟิลด์

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredใน Rust เก็บในชื่อ id
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
asset_classAssetClassRequiredasset class ของ strategy อ้างอิง
exchangeOption<Ustr>NoneMIC ของ exchange หรือรหัส venue (ถ้าทราบ)
underlyingUstrRequiredผลิตภัณฑ์อ้างอิงหรือกลุ่มผลิตภัณฑ์
strategy_typeUstrRequiredประเภท strategy ของ venue เช่น calendar
activation_nsUnixNanosRequiredtimestamp ที่ strategy เริ่มใช้งาน
expiration_nsUnixNanosRequiredtimestamp ที่ strategy หมดอายุ
currencyCurrencyRequiredสกุลเงินของ quote และ settlement
price_precisionu8Requiredจำนวนตำแหน่งทศนิยมที่อนุญาตสำหรับราคา
price_incrementPriceRequiredขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_precisionu8Fixed 0futures spread ซื้อขายเป็นจำนวนสัญญาเต็มเท่านั้น
size_incrementQuantityFixed 1ขั้นขนาดสัญญาที่เล็กที่สุด
multiplierQuantityRequiredตัวคูณของ strategy
lot_sizeQuantityRequiredขนาด lot หรือ lot ของสัญญาที่ปัดแล้ว
margin_initOption<Decimal>0อัตรา initial margin
margin_maintOption<Decimal>0อัตรา maintenance margin
max_quantityOption<Quantity>Noneจำนวนสูงสุดต่อ order
min_quantityOption<Quantity>1จำนวนต่ำสุดต่อ order
max_priceOption<Price>Noneราคา quote หรือ order สูงสุดที่ใช้ได้
min_priceOption<Price>Noneราคา quote หรือ order ต่ำสุดที่ใช้ได้
tick_schemeOption<Ustr>Noneชื่อ tick scheme แบบแปรผันที่ลงทะเบียนไว้
infoOption<Params>Nonemetadata จาก adapter
ts_eventUnixNanosRequiredtimestamp ของ event หน่วย nanosecond
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วย nanosecond

หมายเหตุ: builder ฝั่ง Rust ใช้ชื่อ instrument_id แต่ struct เก็บค่าเดียวกันไว้ในฟิลด์ id

พฤติกรรม

  • FuturesSpread มี instrument class เป็น FuturesSpread
  • venue เผยแพร่ spread นี้เป็น instrument เดียวที่ซื้อขายได้
  • ซื้อขายเป็นจำนวนสัญญาเต็ม โดยมี size precision เป็น 0 และ size increment เป็น 1
  • ราคา spread อาจเป็นศูนย์หรือติดลบได้ และ RiskEngine ยอมรับราคาที่ไม่เป็นบวกสำหรับ instrument class นี้
  • หาก strategy ต้องการรายละเอียดของแต่ละ leg เฉพาะของ venue ให้ใช้ข้อมูล leg จาก metadata ของ adapter

ตัวอย่าง

use jiff::Timestamp;
use nautilus_core::UnixNanos;
use nautilus_model::{
    enums::AssetClass,
    identifiers::{InstrumentId, Symbol},
    instruments::FuturesSpread,
    types::{Currency, Price, Quantity},
};
use ustr::Ustr;

let activation: Timestamp = "2022-06-21T13:30:00Z".parse().unwrap();
let expiration: Timestamp = "2024-06-21T13:30:00Z".parse().unwrap();

let es_spread = FuturesSpread::builder()
    .instrument_id(InstrumentId::from("ESM4-ESU4.GLBX"))
    .raw_symbol(Symbol::from("ESM4-ESU4"))
    .asset_class(AssetClass::Index)
    .exchange(Ustr::from("XCME"))
    .underlying(Ustr::from("ES"))
    .strategy_type(Ustr::from("EQ"))
    .activation_ns(UnixNanos::from(activation))
    .expiration_ns(UnixNanos::from(expiration))
    .currency(Currency::from("USD"))
    .price_precision(2)
    .price_increment(Price::from("0.01"))
    .multiplier(Quantity::from("1"))
    .lot_size(Quantity::from("1"))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapter

Adapter ที่สร้างหรือใช้งาน instrument ประเภท FuturesSpread ได้แก่:

  • Databento สำหรับตลาด futures spread ที่จดทะเบียนซื้อขาย
  • Interactive Brokers สำหรับ futures strategy ที่ exchange กำหนด
  • Futures Contract อธิบาย futures แบบ leg เดียว
  • Continuous Futures อธิบายชุด futures ที่ปรับตามการ roll

แปลจาก เอกสาร NautilusTrader © Nautech Systems Pty Ltd และผู้ร่วมพัฒนา เผยแพร่ภายใต้ LGPL-3.0 ฉบับแปลนี้ตัดเนื้อหาเฉพาะ Python ออกและเน้น Rust