NautilusTrader Docs · ภาษาไทย

Currency Pair

CurrencyPair แทนตลาด spot หรือตลาดเงินสด (cash market) ที่ quote ในรูป BASE/QUOTE โดย base currency คือสินทรัพย์ที่ซื้อหรือขาย และ quote currency คือสกุลเงินที่ใช้ตั้งราคาของ base หนึ่งหน่วย Nautilus ใช้ type นี้กับทั้งคู่เงิน FX แบบ fiat และคู่ crypto spot

ตัวอย่างเช่น EUR/USD.SIM, BTCUSDT.BINANCE และ ETH/USD.KRAKEN

ฟิลด์

FieldRust typeRequired/defaultNotes
instrument_idInstrumentIdRequiredใน Rust เก็บไว้ในชื่อ id
raw_symbolSymbolRequiredsymbol ดั้งเดิมของ venue
base_currencyCurrencyRequiredสินทรัพย์ที่ซื้อหรือขาย
quote_currencyCurrencyRequiredสกุลเงินที่ใช้ตั้งราคาสินทรัพย์ base
price_precisionu8Requiredจำนวนตำแหน่งทศนิยมที่อนุญาตสำหรับราคา
size_precisionu8Requiredจำนวนตำแหน่งทศนิยมที่อนุญาตสำหรับขนาด order
price_incrementPriceRequiredขั้นราคาที่เล็กที่สุดที่ใช้ได้
size_incrementQuantityRequiredขั้นขนาดที่เล็กที่สุดที่ใช้ได้
ts_eventUnixNanosRequiredtimestamp ของ event หน่วยนาโนวินาที
ts_initUnixNanosRequiredtimestamp ตอน initialize หน่วยนาโนวินาที
multiplierQuantity1ตัวคูณของสัญญา (contract multiplier)
lot_sizeOption<Quantity>Noneขนาด 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

พฤติกรรม

  • CurrencyPair มี instrument class เป็น Spot
  • asset class เป็น Cryptocurrency เมื่อสกุลเงินใดสกุลหนึ่งเป็นประเภท crypto หากไม่มีสกุลใดเป็นประเภท crypto จะเป็น FX
  • ไม่มีฟิลด์วันหมดอายุ, strike price, ชนิด option หรือ underlying ของ derivative
  • ไม่เป็น inverse เลย settlement currency และ cost currency คือ quote currency
  • ใช้ type นี้ได้ทั้งกับคู่เงิน FX แบบ fiat และคู่ crypto spot

ให้ใช้ type ของ derivative ที่ตรงกับสินค้าสำหรับ futures ที่มีวันหมดอายุ, swap และ option เพื่อให้ cost currency, settlement currency, วันหมดอายุ และการคำนวณ notional สอดคล้องกับ venue แม้ symbol จะดูเหมือนคู่เงินก็ตาม

ตัวอย่าง

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

let btcusdt = CurrencyPair::builder()
    .instrument_id(InstrumentId::from("BTCUSDT.BINANCE"))
    .raw_symbol(Symbol::from("BTCUSDT"))
    .base_currency(Currency::from("BTC"))
    .quote_currency(Currency::from("USDT"))
    .price_precision(2)
    .size_precision(6)
    .price_increment(Price::from("0.01"))
    .size_increment(Quantity::from("0.000001"))
    .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"))
    .margin_init(dec!(0.001))
    .margin_maint(dec!(0.001))
    .ts_event(UnixNanos::default())
    .ts_init(UnixNanos::default())
    .build()
    .unwrap();

Adapters

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

  • Binance สำหรับตลาด spot
  • Kraken สำหรับตลาด spot
  • OKX สำหรับตลาด spot
  • Tardis สำหรับ metadata ของ spot
  • Interactive Brokers สำหรับสัญญา FX แบบ cash
  • Hyperliquid สำหรับสินทรัพย์ spot
  • Data อธิบาย market data ที่อ้างอิงถึง instrument
  • Execution อธิบายการตรวจสอบ order ที่ใช้ precision ของ instrument
  • Value types อธิบาย Price, Quantity และ Money

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