Class PositionSize

Constructors

constructor

Methods

[dispose] add checkedAddQuantity clone compare div equals free isZero mod mul neg sub toCloseQuantity toJSON toOpenQuantity toString fromFee fromFloat fromFloatRounded fromInt fromPnl fromQuantityAndSide fromString fromStringRounded zero

Constructors

constructor

  • new PositionSize(value): PositionSize

  • Constructs from a DecimalInput (string | number | bigint).

    A generic number must be a safe integer. Use fromFloat explicitly for imprecise fractional input.

    Errors

    Throws ParamError on an invalid value or type.

    Parameters

    • value: string | number | bigint

    Returns PositionSize

Methods

[dispose]

  • [dispose](): void

  • Returns void

add

  • add(other): PositionSize

  • Returns the sum of self and other.

    Errors

    Throws ParamError on overflow (or sign violation for unsigned types).

    Parameters

    Returns PositionSize

checkedAddQuantity

  • checkedAddQuantity(quantity, side): PositionSize

  • Adds a quantity on the given side.

    Errors

    Throws ParamError on overflow or when side is invalid.

    Parameters

    Returns PositionSize

clone

  • clone(): PositionSize

  • Returns a fresh wrapper holding the same value.

    Value types are cheap to copy. Ordinary setters already borrow/clone wrapper inputs; this method is a convenience when an explicit second wrapper object is useful.

    Returns PositionSize

compare

  • compare(other): number

  • Compares against other: -1, 0, or 1.

    Parameters

    Returns number

div

  • div(scalar): PositionSize

  • Divides by a number | bigint scalar.

    Errors

    Throws ParamError on division by zero, overflow, or an invalid scalar.

    Parameters

    • scalar: number | bigint

    Returns PositionSize

equals

  • equals(other): boolean

  • Returns true when both values are equal.

    Parameters

    Returns boolean

free

  • free(): void

  • Returns void

isZero

  • isZero(): boolean

  • Returns true when the value is exactly zero.

    Returns boolean

mod

  • mod(scalar): PositionSize

  • Computes the remainder against a number | bigint scalar.

    Errors

    Throws ParamError on division by zero, overflow, or an invalid scalar.

    Parameters

    • scalar: number | bigint

    Returns PositionSize

mul

  • mul(scalar): PositionSize

  • Multiplies by a number | bigint scalar.

    bigint is exact; number is imprecise.

    Errors

    Throws ParamError on overflow or an invalid scalar.

    Parameters

    • scalar: number | bigint

    Returns PositionSize

neg

  • neg(): PositionSize

  • Returns the negation of this value.

    Errors

    Throws ParamError on arithmetic overflow.

    Returns PositionSize

sub

  • sub(other): PositionSize

  • Returns self minus other.

    Errors

    Throws ParamError on overflow/underflow.

    Parameters

    Returns PositionSize

toCloseQuantity

  • toCloseQuantity(): [Quantity, undefined | "BUY" | "SELL"]

  • Returns the close [Quantity, ("BUY"|"SELL")|undefined] pair.

    The side is undefined when the position is flat.

    Returns [Quantity, undefined | "BUY" | "SELL"]

toJSON

  • toJSON(): string

  • Returns the canonical decimal string for JSON serialization.

    Returns string

toOpenQuantity

  • toOpenQuantity(): [Quantity, "BUY" | "SELL"]

  • Returns the open [Quantity, "BUY"|"SELL"] pair as a 2-element array.

    Returns [Quantity, "BUY" | "SELL"]

toString

  • toString(): string

  • Returns the canonical decimal string.

    Returns string

StaticfromFee

  • fromFee(fee): PositionSize

  • Builds a position size from a fee.

    Parameters

    Returns PositionSize

StaticfromFloat

  • fromFloat(value): PositionSize

  • Constructs from a JS number (imprecise; prefer fromString).

    Errors

    Throws ParamError on a non-finite or out-of-domain value.

    Parameters

    • value: number

    Returns PositionSize

StaticfromFloatRounded

  • fromFloatRounded(value, scale, strategy): PositionSize

  • Constructs from a JS number then quantizes to scale.

    WARNING: the float source is imprecise; prefer fromStringRounded.

    Errors

    Throws ParamError on an invalid value, scale, or strategy.

    Parameters

    • value: number
    • scale: number
    • strategy: string

    Returns PositionSize

StaticfromInt

  • fromInt(value): PositionSize

  • Constructs from an exact integer (bigint).

    Errors

    Throws ParamError on an out-of-domain value.

    Parameters

    • value: bigint

    Returns PositionSize

StaticfromPnl

  • fromPnl(pnl): PositionSize

  • Builds a position size from a P&L value.

    Parameters

    Returns PositionSize

StaticfromQuantityAndSide

  • fromQuantityAndSide(quantity, side): PositionSize

  • Builds a signed position size from a quantity and a side.

    Errors

    Throws ParamError when side is not "BUY"/"SELL".

    Parameters

    Returns PositionSize

StaticfromString

  • fromString(value): PositionSize

  • Constructs losslessly from a decimal string.

    Errors

    Throws ParamError on an invalid format or out-of-domain value.

    Parameters

    • value: string

    Returns PositionSize

StaticfromStringRounded

  • fromStringRounded(value, scale, strategy): PositionSize

  • Parses a decimal string then quantizes to scale using strategy.

    Errors

    Throws ParamError on an invalid value, scale, or strategy.

    Parameters

    • value: string
    • scale: number
    • strategy: string

    Returns PositionSize

Staticzero

Settings

Member Visibility

On This Page

Constructors
Methods