NautilusTrader Docs · ภาษาไทย

Futures Contract

FuturesContract แทนสัญญา futures แบบมีวันหมดอายุที่ซื้อขายในตลาด exchange โดยมี underlying, เวลาเริ่ม active, เวลาหมดอายุ, สกุลเงิน, multiplier และ lot size ที่กำหนดไว้

ตัวอย่างเช่น equity index futures, commodity futures, interest-rate futures และ currency futures

Fields

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredเก็บเป็น id ใน Rust
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
asset_classAssetClassRequiredasset class ของ underlying
exchangeOption<Ustr>NoneMIC ของ exchange หรือรหัส venue หากทราบ
underlyingUstrRequiredสินทรัพย์ ดัชนี หรือผลิตภัณฑ์อ้างอิง
activation_nsUnixNanosRequiredtimestamp ที่สัญญาเริ่ม active
expiration_nsUnixNanosRequiredtimestamp ที่สัญญาหมดอายุ
currencyCurrencyRequiredสกุลเงินสำหรับ quote และ settlement
price_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับราคา
price_incrementPriceRequiredstep ของราคาที่เล็กที่สุดที่ใช้ได้
size_precisionu8Fixed 0futures ซื้อขายเป็นจำนวนสัญญาเต็ม
size_incrementQuantityFixed 1step ของขนาดสัญญาที่เล็กที่สุด
multiplierQuantityRequiredmultiplier ของสัญญา
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ชื่อ variable tick scheme ที่ลงทะเบียนไว้
infoOption<Params>Nonemetadata จาก adapter
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที

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

พฤติกรรม

  • FuturesContract มี instrument class เป็น Future
  • ไม่เป็น inverse ต้นทุน settlement และ quote currency ใช้ currency
  • ราคาเป็นศูนย์หรือติดลบได้
  • ซื้อขายเป็นจำนวนสัญญาเต็ม โดยมี size precision เป็น 0 และ size increment เป็น 1
  • ใช้ CryptoFuture สำหรับ crypto futures แบบมีวันหมดอายุที่สกุลเงินของ underlying และ settlement อาจต่างกัน

ตัวอย่าง

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

let activation: Timestamp = "2021-09-10T00:00:00Z".parse().unwrap();
let expiration: Timestamp = "2021-12-17T00:00:00Z".parse().unwrap();

let esz21 = FuturesContract::builder()
    .instrument_id(InstrumentId::from("ESZ21.GLBX"))
    .raw_symbol(Symbol::from("ESZ21"))
    .asset_class(AssetClass::Index)
    .exchange(Ustr::from("XCME"))
    .underlying(Ustr::from("ES"))
    .activation_ns(UnixNanos::from(activation))
    .expiration_ns(UnixNanos::from(expiration))
    .currency(Currency::from("USD"))
    .price_precision(2)
    .price_increment(Price::from("0.25"))
    .multiplier(Quantity::from("1"))
    .lot_size(Quantity::from("1"))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapters

Adapter ที่สร้างหรือใช้ instrument แบบ FuturesContract ได้แก่:

  • Databento สำหรับ reference data และ market data ของ futures
  • Interactive Brokers สำหรับสัญญา futures ที่จดทะเบียนในตลาด
  • Continuous Futures อธิบายชุดข้อมูล futures ที่ปรับตามการ roll
  • Crypto Future อธิบายสัญญา crypto futures แบบมีวันหมดอายุ

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