NautilusTrader Docs · ภาษาไทย

Crypto Perpetual

CryptoPerpetual แทนสัญญา crypto perpetual futures หรือที่เรียกว่า perpetual swap สัญญาประเภทนี้ ไม่มีวันหมดอายุ อ้างอิง crypto base asset และ settle ด้วย crypto, stablecoin หรือ settlement currency อื่นที่ venue กำหนด

ตัวอย่างเช่น ETHUSDT-PERP.BINANCE, BTCUSD.BYBIT และ BTC-USD-SWAP.OKX

ฟิลด์

FieldRust typeRequired/defaultหมายเหตุ
instrument_idInstrumentIdRequiredRust เก็บไว้ในชื่อ id
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
base_currencyCurrencyRequiredcrypto asset หลัก (base)
quote_currencyCurrencyRequiredสกุลเงินที่ใช้ quote ราคา
settlement_currencyCurrencyRequiredสกุลเงินที่ใช้ settle PnL และค่าธรรมเนียม
is_inverseboolRequiredเป็น true เมื่อการคิดขนาด/ต้นทุนเป็นแบบ inverse
price_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับราคา
size_precisionu8Requiredจำนวนทศนิยมที่อนุญาตสำหรับขนาด order
price_incrementPriceRequiredขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_incrementQuantityRequiredขั้นขนาดที่เล็กที่สุดที่ใช้ได้
ts_eventUnixNanosRequiredtimestamp ของ event หน่วย nanoseconds
ts_initUnixNanosRequiredtimestamp ตอนสร้าง object หน่วย nanoseconds
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

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

พฤติกรรม

  • CryptoPerpetual มี asset class เป็น Cryptocurrency และ instrument class เป็น Swap
  • ไม่มี activation timestamp หรือ expiration timestamp

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

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

Cost currency: ใช้ base สำหรับสัญญา inverse, ใช้ settlement สำหรับสัญญา quanto และใช้ quote ในกรณีอื่น

funding payment ไม่ได้เป็นฟิลด์ของ instrument แต่จะเข้ามาในรูปของ data เช่น FundingRateUpdate ซึ่งอ้างอิงถึง instrument ID

ตัวอย่าง

use nautilus_core::UnixNanos;
use nautilus_model::{
    identifiers::{InstrumentId, Symbol},
    instruments::{CryptoPerpetual, InstrumentAny},
    types::{Currency, Money, Price, Quantity},
};
use rust_decimal_macros::dec;

let ethusdt_perp = CryptoPerpetual::builder()
    .instrument_id(InstrumentId::from("ETHUSDT-PERP.BINANCE"))
    .raw_symbol(Symbol::from("ETHUSDT"))
    .base_currency(Currency::from("ETH"))
    .quote_currency(Currency::from("USDT"))
    .settlement_currency(Currency::from("USDT"))
    .is_inverse(false)
    .price_precision(2)
    .size_precision(3)
    .price_increment(Price::from("0.01"))
    .size_increment(Quantity::from("0.001"))
    .max_quantity(Quantity::from("10000.000"))
    .min_quantity(Quantity::from("0.001"))
    .min_notional(Money::from("10.00 USDT"))
    .max_price(Price::from("15000.00"))
    .min_price(Price::from("1.00"))
    .margin_init(dec!(1.0))
    .margin_maint(dec!(0.35))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

let instrument = InstrumentAny::CryptoPerpetual(ethusdt_perp);

Adapter

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

  • Binance สำหรับ perpetual futures แบบ USD-M และ COIN-M
  • Bybit สำหรับผลิตภัณฑ์ perpetual แบบ linear และ inverse
  • dYdX สำหรับตลาด perpetual
  • Hyperliquid สำหรับตลาด perpetual
  • Kraken สำหรับตลาด perpetual ของ futures venue
  • OKX สำหรับตลาด swap
  • Tardis สำหรับ metadata ของ crypto perpetual
  • Data อธิบาย mark price, index price และ funding rate update
  • Options อธิบายประเภท instrument เฉพาะของ option
  • Execution อธิบายการตรวจสอบ precision และ notional ก่อนที่ order จะไปถึง venue

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