value

Documentation

Index

• Constants
• type NumericValue
• type Pair
  • func PairFromString(s string) (p Pair, err error)
  • func (p Pair) Empty() bool
  • func (p Pair) Equal(c Pair) bool
  • func (p Pair) Invert() Pair
  • func (p Pair) MarshalText() ([]byte, error)
  • func (p Pair) String() string
  • func (p *Pair) UnmarshalText(text []byte) error
• type StaticValue
  • func (s StaticValue) MarshalJSON() ([]byte, error)
  • func (s StaticValue) Number() *bn.FloatNumber
  • func (s StaticValue) Print() string
  • func (s *StaticValue) UnmarshalJSON(bytes []byte) error
• type Tick
  • func (t Tick) MarshalJSON() ([]byte, error)
  • func (t Tick) Number() *bn.FloatNumber
  • func (t Tick) Print() string
  • func (t *Tick) UnmarshalJSON(data []byte) error
  • func (t Tick) Validate() error
• type ValidatableValue
• type Value

Constants

const StaticNumberPrecision = 18

StaticNumberPrecision is a precision of static numbers.

const TickPricePrecision = 18

TickPricePrecision specified number of decimal places for tick prices during marshaling.

const TickVolumePrecision = 18

TickVolumePrecision specified number of decimal places for tick volumes during marshaling.

Types

type NumericValue

type NumericValue interface {
	Number() *bn.FloatNumber
}

NumericValue is a data point value which is a number.

The interface must be implemented by using non-pointer receivers.

type Pair

type Pair struct {
	Base  string
	Quote string
}

Pair represents an asset pair.

func PairFromString

func PairFromString(s string) (p Pair, err error)

PairFromString returns a new Pair for given string. The string must be formatted as "BASE/QUOTE".

func (Pair) Empty

func (p Pair) Empty() bool

Empty returns true if the pair is empty. Pair is considered empty if either base or quote is empty.

func (Pair) Equal

func (p Pair) Equal(c Pair) bool

Equal returns true if the pair is equal to the given pair.

func (Pair) Invert

func (p Pair) Invert() Pair

Invert returns an inverted pair. For example, if the pair is "BTC/USD", then the inverted pair is "USD/BTC".

func (Pair) MarshalText

func (p Pair) MarshalText() ([]byte, error)

MarshalText implements encoding.TextMarshaler interface.

func (Pair) String

func (p Pair) String() string

String returns a string representation of the pair.

func (*Pair) UnmarshalText

func (p *Pair) UnmarshalText(text []byte) error

UnmarshalText implements encoding.TextUnmarshaler interface.

type StaticValue

type StaticValue struct {
	Value *bn.FloatNumber
}

StaticValue is a numeric value obtained from a static origin.

func (StaticValue) MarshalJSON

func (s StaticValue) MarshalJSON() ([]byte, error)

func (StaticValue) Number

func (s StaticValue) Number() *bn.FloatNumber

Number implements the NumericValue interface.

func (StaticValue) Print

func (s StaticValue) Print() string

Print implements the Value interface.

func (*StaticValue) UnmarshalJSON

func (s *StaticValue) UnmarshalJSON(bytes []byte) error

type Tick

type Tick struct {
	// Pair is an asset pair for which this price is calculated.
	Pair Pair

	// Price is a price for the given asset pair.
	// Depending on the provider implementation, this price can be
	// a last trade price, an average of bid and ask prices, etc.
	//
	// Price is always non-nil if there is no error.
	Price *bn.FloatNumber

	// Volume24h is a 24h volume for the given asset pair presented in the
	// base currency.
	//
	// May be nil if the provider does not provide volume.
	Volume24h *bn.FloatNumber
}

Tick contains a price, volume and other information for a given asset pair at a given time.

Before using this data, you should check if it is valid by calling Tick.Validate() method.

During marshaling, the price and volume are converted to fixed-point numbers with the precision specified by TickPricePrecision and TickVolumePrecision constants.

func (Tick) MarshalJSON

func (t Tick) MarshalJSON() ([]byte, error)

func (Tick) Number

func (t Tick) Number() *bn.FloatNumber

Number implements the NumericValue interface.

func (Tick) Print

func (t Tick) Print() string

Print implements the Value interface.

func (*Tick) UnmarshalJSON

func (t *Tick) UnmarshalJSON(data []byte) error

func (Tick) Validate

func (t Tick) Validate() error

Validate returns an error if the tick is invalid.

type ValidatableValue

type ValidatableValue interface {
	Validate() error
}

ValidatableValue is a data point value which can be validated.

The interface must be implemented by using non-pointer receivers.

type Value

type Value interface {
	// Print returns a human-readable representation of the value.
	Print() string
}

Value is a data point value.

A value can be anything, e.g. a number, a string, a struct, etc.

The interface must be implemented by using non-pointer receivers.