NautilusTrader Docs · ภาษาไทย

Perpetual Contract

PerpetualContract แทนสัญญา perpetual futures แบบทั่วไปที่ใช้ได้กับทุก asset class ใช้เมื่อ venue มี perpetual swap ที่ไม่ได้ถูก model ไว้เป็น CryptoPerpetual โดยเฉพาะ

ตัวอย่างเช่น สัญญา perpetual ที่ไม่ใช่ crypto และ synthetic swap เฉพาะของแต่ละ venue

ฟิลด์

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredRust เก็บไว้ในชื่อ id
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
underlyingUstrRequiredสินทรัพย์อ้างอิงหรือตลาดอ้างอิง
asset_classAssetClassRequiredasset class ของสินทรัพย์อ้างอิง
base_currencyOption<Currency>Noneสกุลเงินหลัก จำเป็นสำหรับแบบ inverse
quote_currencyCurrencyRequiredสกุลเงินที่ใช้ quote ราคา
settlement_currencyCurrencyRequiredสกุลเงินที่ใช้ settle PnL และค่าธรรมเนียม
is_inverseboolRequiredเป็น true เมื่อการคิดขนาด/ต้นทุนเป็นแบบ inverse
price_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับราคา
size_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับขนาด order
price_incrementPriceRequiredขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_incrementQuantityRequiredขั้นขนาดที่เล็กที่สุดที่ใช้ได้
multiplierQuantity1ตัวคูณของสัญญา
lot_sizeQuantity1ขนาด lot หรือ board ที่ปัดแล้ว
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ชื่อ variable tick scheme ที่ลงทะเบียนไว้
infoOption<Params>Nonemetadata ของ adapter
ts_eventUnixNanosRequiredtimestamp ของ event หน่วย nanoseconds
ts_initUnixNanosRequiredtimestamp ตอนสร้าง object หน่วย nanoseconds

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

พฤติกรรม

  • PerpetualContract มี instrument class เป็น Swap
  • ไม่มี activation timestamp หรือ expiration timestamp
  • สัญญาแบบ inverse ต้องมี base currency
  • สัญญาแบบ linear โดยทั่วไป settle ด้วย quote currency
  • ใช้ CryptoPerpetual สำหรับ crypto perpetual ที่ base asset เป็นสกุลเงิน

ตัวอย่าง

use nautilus_core::UnixNanos;
use nautilus_model::{
    enums::AssetClass,
    identifiers::{InstrumentId, Symbol},
    instruments::PerpetualContract,
    types::{Currency, Price, Quantity},
};
use rust_decimal_macros::dec;
use ustr::Ustr;

let eurusd_perp = PerpetualContract::builder()
    .instrument_id(InstrumentId::from("EURUSD-PERP.AX"))
    .raw_symbol(Symbol::from("EURUSD-PERP"))
    .underlying(Ustr::from("EURUSD"))
    .asset_class(AssetClass::FX)
    .base_currency(Currency::from("EUR"))
    .quote_currency(Currency::from("USD"))
    .settlement_currency(Currency::from("USD"))
    .is_inverse(false)
    .price_precision(5)
    .size_precision(0)
    .price_increment(Price::from("0.00001"))
    .size_increment(Quantity::from("1"))
    .margin_init(dec!(0.03))
    .margin_maint(dec!(0.03))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapter

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

  • Architect AX สำหรับสัญญา perpetual ที่ venue กำหนด
  • Binance สำหรับสัญญา perpetual แบบ USD-M TradFi
  • Crypto Perpetual อธิบาย crypto perpetual futures
  • Data อธิบาย mark price, index price และ funding rate update

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