Struct Price 

#[repr(C)]
pub struct Price {
    pub raw: PriceRaw,
    pub precision: u8,
}

Represents a price in a market with a specified precision.

The number of decimal places may vary. For certain asset classes, prices may have negative values. For example, prices for options instruments can be negative under certain conditions.

Handles up to FIXED_PRECISION decimals of precision.

• PRICE_MAX - Maximum representable price value.
• PRICE_MIN - Minimum representable price value.

Fields

raw: PriceRaw

Represents the raw fixed-point value, with precision defining the number of decimal places.

precision: u8

The number of decimal places, with a maximum of FIXED_PRECISION.

Implementations

impl Price

pub fn new_checked(value: f64, precision: u8) -> Result<Self>

Creates a new Price instance with correctness checking.

Errors

Returns an error if:

• value is invalid outside the representable range [PRICE_MIN, PRICE_MAX].
• precision is invalid outside the representable range [0, `FIXED_PRECISION``].

Notes

PyO3 requires a Result type for proper error handling and stacktrace printing in Python.

pub fn new(value: f64, precision: u8) -> Self

Creates a new Price instance.

Panics

Panics if a correctness check fails. See Price::new_checked for more details.

pub fn from_raw(raw: PriceRaw, precision: u8) -> Self

Creates a new Price instance from the given raw fixed-point value and precision.

Panics

Panics if a correctness check fails. See Price::new_checked for more details.

pub fn zero(precision: u8) -> Self

Creates a new Price instance with a value of zero with the given precision.

Panics

Panics if a correctness check fails. See Price::new_checked for more details.

pub fn max(precision: u8) -> Self

Creates a new Price instance with the maximum representable value with the given precision.

Panics

Panics if a correctness check fails. See Price::new_checked for more details.

pub fn min(precision: u8) -> Self

Creates a new Price instance with the minimum representable value with the given precision.

Panics

Panics if a correctness check fails. See Price::new_checked for more details.

pub fn is_undefined(&self) -> bool

Returns true if the value of this instance is undefined.

pub fn is_zero(&self) -> bool

Returns true if the value of this instance is zero.

pub fn is_positive(&self) -> bool

Returns true if the value of this instance is position (> 0).

pub fn as_f64(&self) -> f64

Returns the value of this instance as an f64.

Panics

Panics if precision is beyond MAX_FLOAT_PRECISION (16).

pub fn as_decimal(&self) -> Decimal

Returns the value of this instance as a Decimal.

pub fn to_formatted_string(&self) -> String

Returns a formatted string representation of this instance.

pub fn from_decimal(decimal: Decimal, precision: u8) -> Result<Self>

Creates a new Price from a Decimal value with specified precision.

This method provides more reliable parsing by using Decimal arithmetic to avoid floating-point precision issues during conversion.

Errors

Returns an error if:

• precision exceeds FIXED_PRECISION.
• The decimal value cannot be converted to the raw representation.
• Overflow occurs during scaling.

impl Price

pub fn from_wei<U>(raw_wei: U) -> Self

where U: Into<U256>,

Constructs a Price from a raw amount expressed in wei (18-decimal fixed-point).

The resulting Price will always have precision equal to 18.

Panics

Panics if the supplied raw_wei cannot fit into a signed 128-bit integer (this would exceed the numeric range of the internal PriceRaw representation).

pub fn as_wei(&self) -> U256

Converts this Price to a wei amount (U256).

Only valid for prices with precision 18. For other precisions convert to precision 18 first.

Panics

Panics if the price has precision other than 18 or if the raw value is negative.

Trait Implementations

impl Add<f64> for Price

type Output = f64

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> Self::Output

Performs the + operation.

impl Add for Price

type Output = Price

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl AddAssign for Price

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl Clone for Price

fn clone(&self) -> Price

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Price

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Price

fn default() -> Price

Returns the “default value” for a type.

impl Deref for Price

type Target = i128

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'de> Deserialize<'de> for Price

fn deserialize<D>(_deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Price

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&Price> for f64

fn from(price: &Price) -> Self

Converts to this type from the input type.

impl From<Price> for f64

fn from(price: Price) -> Self

Converts to this type from the input type.

impl<T: AsRef<str>> From<T> for Price

fn from(value: T) -> Self

Converts to this type from the input type.

impl FromStr for Price

type Err = String

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Price

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'py> IntoPyObject<'py> for Price

type Target = Price

The Python output type

type Output = Bound<'py, <Price as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl Mul<f64> for Price

type Output = f64

The resulting type after applying the * operator.

fn mul(self, rhs: f64) -> Self::Output

Performs the * operation.

impl Neg for Price

type Output = Price

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl Ord for Price

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Price

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Price

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Self) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Self) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Self) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Self) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PyClass for Price

type Frozen = True

Whether the pyclass is frozen.

impl PyClassImpl for Price

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

const RAW_DOC: &'static CStr = /// Represents a price in a market with a specified precision. /// /// The number of decimal places may vary. For certain asset classes, prices may /// have negative values. For example, prices for options instruments can be /// negative under certain conditions. /// /// Handles up to [`FIXED_PRECISION`] decimals of precision. /// /// - [`PRICE_MAX`] - Maximum representable price value. /// - [`PRICE_MIN`] - Minimum representable price value.

Docstring for the class provided on the struct or enum.

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined.

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<Price>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::ImmutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature for Price

const TEXT_SIGNATURE: &'static str = "(value, precision)"

impl PyClass__add__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __add__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__floordiv__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __floordiv__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__mod__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __mod__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__mul__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __mul__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__radd__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __radd__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__rfloordiv__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __rfloordiv__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__rmod__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __rmod__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__rmul__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __rmul__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__rsub__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __rsub__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__rtruediv__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __rtruediv__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__sub__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __sub__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl PyClass__truediv__SlotFragment<Price> for PyClassImplCollector<Price>

unsafe fn __truediv__( self, py: Python<'_>, _raw_slf: *mut PyObject, arg0: *mut PyObject, ) -> PyResult<*mut PyObject>

Safety: _slf and _other must be valid non-null Python objects

impl<'a, 'holder, 'py> PyFunctionArgument<'a, 'holder, 'py, false> for &'holder Price

type Holder = Option<PyClassGuard<'a, Price>>

fn extract( obj: &'a Bound<'py, PyAny>, holder: &'holder mut Self::Holder, ) -> PyResult<Self>

impl PyMethods<Price> for PyClassImplCollector<Price>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for Price

const NAME: &'static str = "Price"

Class name.

const MODULE: Option<&'static str>

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl Serialize for Price

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<f64> for Price

type Output = f64

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> Self::Output

Performs the - operation.

impl Sub for Price

type Output = Price

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl SubAssign for Price

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl Copy for Price

impl DerefToPyAny for Price

impl Eq for Price