NautilusTrader Docs · ภาษาไทย

Crypto Futures Spread

CryptoFuturesSpread แทน spread strategy ที่ exchange กำหนดขึ้นบน crypto futures venue จะเผยแพร่ strategy นี้เป็น instrument เดียวที่มี symbol, ประเภท strategy, precision, increment และวันหมดอายุเป็นของตัวเอง

ตัวอย่างเช่น crypto futures calendar spread ที่จดทะเบียนซื้อขายใน exchange

Field

FieldRust typeจำเป็น/ค่าเริ่มต้นหมายเหตุ
instrument_idInstrumentIdจำเป็นใน Rust เก็บเป็น id
raw_symbolSymbolจำเป็นsymbol ดั้งเดิมของ venue
underlyingCurrencyจำเป็นcrypto asset ที่ strategy อ้างอิง
quote_currencyCurrencyจำเป็นสกุลเงินที่ใช้ quote ราคา
settlement_currencyCurrencyจำเป็นสกุลเงินที่ใช้ settle PnL และค่าธรรมเนียม
is_inverseboolจำเป็นเป็น true เมื่อการคิดขนาด/ต้นทุนเป็นแบบ inverse
strategy_typeUstrจำเป็นประเภท strategy ของ venue เช่น calendar
activation_nsUnixNanosจำเป็นtimestamp ที่ strategy เริ่มใช้งาน
expiration_nsUnixNanosจำเป็นtimestamp ที่ strategy หมดอายุ
price_precisionu8จำเป็นจำนวนทศนิยมที่อนุญาตสำหรับราคา
size_precisionu8จำเป็นจำนวนทศนิยมที่อนุญาตสำหรับขนาด order
price_incrementPriceจำเป็นขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_incrementQuantityจำเป็นขั้นขนาดที่เล็กที่สุดที่ใช้ได้
multiplierQuantity1ตัวคูณของ strategy
lot_sizeQuantity1ขนาด lot หรือ board แบบปัดเศษ
max_quantityOption<Quantity>Nonequantity สูงสุดของ order
min_quantityOption<Quantity>Nonequantity ต่ำสุดของ order
max_notionalOption<Money>Noneมูลค่า notional สูงสุดของ order
min_notionalOption<Money>Noneมูลค่า notional ต่ำสุดของ order
max_priceOption<Price>Noneราคา quote หรือ order สูงสุดที่ใช้ได้
min_priceOption<Price>Noneราคา quote หรือ order ต่ำสุดที่ใช้ได้
margin_initOption<Decimal>0อัตรา initial margin
margin_maintOption<Decimal>0อัตรา maintenance margin
tick_schemeOption<Ustr>Noneชื่อ variable tick scheme ที่ลงทะเบียนไว้
infoOption<Params>Nonemetadata ของ adapter
ts_eventUnixNanosจำเป็นtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosจำเป็นtimestamp ตอน initialize หน่วยนาโนวินาที

พฤติกรรม

  • CryptoFuturesSpread มี asset class เป็น Cryptocurrency และ instrument class เป็น FuturesSpread
  • venue เผยแพร่ spread เป็น instrument เดียวที่ซื้อขายได้
  • strategy อาจเป็นแบบ linear, inverse หรือ quanto ขึ้นอยู่กับชุดสกุลเงิน
  • ราคา spread อาจเป็นศูนย์หรือติดลบได้ และ RiskEngine ยอมรับราคาที่ไม่เป็นบวกสำหรับ instrument class นี้ ยกเว้น spread แบบ inverse
  • หาก adapter มีรายละเอียด leg เฉพาะของ venue ให้ ให้เก็บไว้ใน info

ตัวอย่าง

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

let activation: Timestamp = "2026-05-12T00:00:00Z".parse().unwrap();
let expiration: Timestamp = "2026-05-19T08:00:00Z".parse().unwrap();

let btc_spread = CryptoFuturesSpread::builder()
    .instrument_id(InstrumentId::from("BTC-FS-19MAY26_PERP.DERIBIT"))
    .raw_symbol(Symbol::from("BTC-FS-19MAY26_PERP"))
    .underlying(Currency::from("BTC"))
    .quote_currency(Currency::from("USD"))
    .settlement_currency(Currency::from("BTC"))
    .is_inverse(false)
    .strategy_type(Ustr::from("FS"))
    .activation_ns(UnixNanos::from(activation))
    .expiration_ns(UnixNanos::from(expiration))
    .price_precision(1)
    .size_precision(0)
    .price_increment(Price::from("0.5"))
    .size_increment(Quantity::from("1"))
    .multiplier(Quantity::from("10"))
    .lot_size(Quantity::from("1"))
    .min_quantity(Quantity::from("1"))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapter

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

  • Deribit สำหรับ crypto futures combo
  • OKX สำหรับตลาด crypto futures spread
  • Crypto Future อธิบาย crypto futures แบบมีวันหมดอายุที่มี leg เดียว
  • Futures Spread อธิบาย futures spread ที่ไม่ใช่ crypto

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