NautilusTrader Docs · ภาษาไทย

Crypto Future

CryptoFuture แทนสัญญา crypto futures ที่มีวันครบกำหนด โดยอ้างอิง underlying ที่เป็น crypto, quote ราคาด้วย quote currency, settle ด้วย settlement currency และหมดอายุ ณ timestamp ที่กำหนดไว้

ตัวอย่างเช่น futures ของ BTC หรือ ETH แบบมีวันครบกำหนดบน venue ซื้อขาย crypto derivatives

Fields

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredใน Rust เก็บไว้ใน field id
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
underlyingCurrencyRequiredcrypto asset ที่สัญญาอ้างอิง
quote_currencyCurrencyRequiredสกุลเงินที่ใช้ quote ราคา
settlement_currencyCurrencyRequiredสกุลเงินที่ใช้ settle PnL และค่าธรรมเนียม
is_inverseboolRequiredเป็น true เมื่อการคิดขนาด/ต้นทุนเป็นแบบ inverse
activation_nsUnixNanosRequiredtimestamp ที่สัญญาเริ่มใช้งาน
expiration_nsUnixNanosRequiredtimestamp ที่สัญญาหมดอายุ
price_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับราคา
size_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับขนาด order
price_incrementPriceRequiredขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_incrementQuantityRequiredขั้นขนาดที่เล็กที่สุดที่ใช้ได้
multiplierQuantity1ตัวคูณของสัญญา
lot_sizeQuantity1ขนาด lot หรือ board lot
max_quantityOption<Quantity>Noneปริมาณ order สูงสุด
min_quantityOption<Quantity>Noneปริมาณ 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ชื่อ tick scheme แบบแปรผันที่ลงทะเบียนไว้
infoOption<Params>Nonemetadata จาก adapter
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที

หมายเหตุ: builder ใช้ชื่อ instrument_id แต่ Rust เก็บค่าเดียวกันนี้ไว้ใน field id

พฤติกรรม

  • CryptoFuture มี asset class เป็น Cryptocurrency และ instrument class เป็น Future
  • ราคาเป็นศูนย์หรือติดลบได้ ยกเว้น inverse futures
  • ใช้ CryptoPerpetual สำหรับ crypto derivatives ที่ไม่มีวันหมดอายุ

รูปแบบการ settle: ชุดสกุลเงินที่กำหนดเป็นตัวบอกรูปแบบการ settle

  • Linear: โดยทั่วไปตั้ง is_inverse=False และ settle ด้วย quote currency
  • Inverse: ตั้ง is_inverse=True และโดยทั่วไป settle ด้วยสกุลเงินของ underlying
  • Quanto: settle ด้วยสกุลเงินที่สามซึ่งต่างจากทั้ง underlying และ quote

ตัวอย่าง

use jiff::Timestamp;
use nautilus_core::UnixNanos;
use nautilus_model::{
    identifiers::{InstrumentId, Symbol},
    instruments::CryptoFuture,
    types::{Currency, Money, Price, Quantity},
};

let activation: Timestamp = "2024-01-08T00:00:00Z".parse().unwrap();
let expiration: Timestamp = "2024-03-29T00:00:00Z".parse().unwrap();

let btcusdt_future = CryptoFuture::builder()
    .instrument_id(InstrumentId::from("BTCUSDT-240329.BINANCE"))
    .raw_symbol(Symbol::from("BTCUSDT-240329"))
    .underlying(Currency::from("BTC"))
    .quote_currency(Currency::from("USDT"))
    .settlement_currency(Currency::from("USDT"))
    .is_inverse(false)
    .activation_ns(UnixNanos::from(activation))
    .expiration_ns(UnixNanos::from(expiration))
    .price_precision(2)
    .size_precision(6)
    .price_increment(Price::from("0.01"))
    .size_increment(Quantity::from("0.000001"))
    .max_quantity(Quantity::from("9000.0"))
    .min_quantity(Quantity::from("0.000001"))
    .min_notional(Money::from("10.00 USDT"))
    .max_price(Price::from("1000000.00"))
    .min_price(Price::from("0.01"))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapters

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

  • Bybit สำหรับตลาด crypto futures
  • Deribit สำหรับ crypto futures แบบมีวันครบกำหนด
  • OKX สำหรับ crypto futures แบบมีวันครบกำหนด
  • Tardis สำหรับ metadata ของ crypto futures

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