Class OrdersAPI

Represents a class for handling Orderbook (OB) related operations.

Hierarchy

BaseAPI
- OrdersAPI

Constructors

constructor

new OrdersAPI(premia): OrdersAPI
Construct a new BaseAPI object.
Parameters
- premia: Premia
  
  An instance of the Premia SDK.
Returns OrdersAPI
Inherited from BaseAPI.constructor
- Defined in src/api/baseAPI.ts:17

Properties

`Readonly` premia

premia: Premia

Methods

`Private` bestQuote

bestQuote(quotes, size, minimumSize?): Promise<null | OrderbookQuote>
Private
Selects the best quote from a list of quotes based on a pricing strategy.
Parameters
- quotes: OrderbookQuote[]
  
  An array of quotes.
- size: BigNumberish
  
  The size of the trade.
- Optional minimumSize: BigNumberish
  
  The minimum size of the trade (optional).
Returns Promise<null | OrderbookQuote>
- A promise resolving to the best quote from the array of quotes, or null if no valid quote is found.
- Defined in src/api/ordersAPI.ts:47

calculateQuoteHash

calculateQuoteHash(quote, poolAddress): string
Calculates the hash of a quote.

Method
calculateQuoteHash
Parameters
- quote: QuoteT
  
  The quote to hash.
- poolAddress: string
  
  The address of the pool.
Returns string
The calculated hash of the quote.
- Defined in src/api/ordersAPI.ts:595

cancelAllStreams

cancelAllStreams(): void
Cancels all active quotes streams.

Returns void
- Defined in src/api/ordersAPI.ts:321

cancelQuoteStream

cancelQuoteStream(): void
Cancels the quotes stream for orderbook quotes.

Returns void
- Defined in src/api/ordersAPI.ts:312

isQuoteValid

isQuoteValid(quote, size?, throwError?): Promise<boolean>
Checks whether a quote is valid. Can optionally throw an error if the quote is invalid.
Parameters
- quote: OrderbookQuote
  
  The quote to check.
- Optional size: BigNumberish
  
  The size of the trade (optional).
- Optional throwError: boolean = false
  
  Whether to throw an error if the quote is invalid (default is false).
Returns Promise<boolean>
- A promise that resolves to a boolean indicating whether the quote is valid.
- Defined in src/api/ordersAPI.ts:124

publishQuote

publishQuote(quote): Promise<null | TransactionReceipt>
Publishes a quote.
Parameters
- quote: QuoteWithSignatureT
  
  The quote to publish.
Returns Promise<null | TransactionReceipt>
A promise that resolves to the transaction receipt or null if failed.
- Defined in src/api/ordersAPI.ts:418

publishQuoteWithApiKey

publishQuoteWithApiKey(quote): Promise<OrderbookQuote[]>
Publishes a quote using an API key.
Parameters
- quote: QuoteWithSignatureT
  
  The quote to publish.
Returns Promise<OrderbookQuote[]>
- A promise that resolves to the published quote.
- Defined in src/api/ordersAPI.ts:332

publishQuotes

publishQuotes(quotes): Promise<null | TransactionReceipt>
Publishes a list of quotes.
Parameters
- quotes: QuoteWithSignatureT[]
  
  The list of quotes to publish.
Returns Promise<null | TransactionReceipt>
A promise that resolves to the transaction receipt or null if failed.
- Defined in src/api/ordersAPI.ts:430

publishQuotesWithApiKey

publishQuotesWithApiKey(quotes): Promise<OrderbookQuote[]>
Publishes a list of quotes with an API key.
Parameters
- quotes: QuoteWithSignatureT[]
  
  The list of quotes to publish.
Returns Promise<OrderbookQuote[]>
A promise that resolves to the list of returned OB quotes.
- Defined in src/api/ordersAPI.ts:344

publishUnsignedQuote

publishUnsignedQuote(poolAddress, quote): Promise<null | TransactionReceipt>
Publishes an unsigned quote.
Parameters
- poolAddress: string
  
  The address of the pool.
- quote: QuoteSaltOptionalT
  
  The unsigned quote to publish.
Returns Promise<null | TransactionReceipt>
A promise that resolves to the transaction receipt or null if failed.
- Defined in src/api/ordersAPI.ts:388

publishUnsignedQuoteWithApiKey

publishUnsignedQuoteWithApiKey(poolAddress, quote): Promise<OrderbookQuote[]>
Publishes an unsigned quote with an API key.
Parameters
- poolAddress: string
  
  The address of the pool.
- quote: QuoteSaltOptionalT
  
  The unsigned quote to publish.
Returns Promise<OrderbookQuote[]>
A promise that resolves to the list of returned OB quotes.
- Defined in src/api/ordersAPI.ts:357

publishUnsignedQuotes

publishUnsignedQuotes(poolAddress, quotes): Promise<null | TransactionReceipt>
Publishes a list of unsigned quotes.
Parameters
- poolAddress: string
  
  The address of the pool.
- quotes: QuoteSaltOptionalT[]
  
  The list of unsigned quotes to publish.
Returns Promise<null | TransactionReceipt>
A promise that resolves to the transaction receipt or null if failed.
- Defined in src/api/ordersAPI.ts:402

publishUnsignedQuotesWithApiKey

publishUnsignedQuotesWithApiKey(poolAddress, quotes): Promise<OrderbookQuote[]>
Publishes a list of unsigned quotes with an API key.
Parameters
- poolAddress: string
  
  The address of the pool.
- quotes: QuoteSaltOptionalT[]
  
  The list of unsigned quotes to publish.
Returns Promise<OrderbookQuote[]>
A promise that resolves to the list of returned OB quotes.
- Defined in src/api/ordersAPI.ts:371

quote

quote(poolAddress, size, isBuy, minimumSize?, referrer?, taker?): Promise<null | FillableQuote>
Fetches the best quote for a specified pool address and trade size.
Parameters
- poolAddress: string
  
  The address of the pool.
- size: BigNumberish
  
  The size of the trade.
- isBuy: boolean
  
  Whether it's a buy or a sell.
- Optional minimumSize: BigNumberish
  
  The minimum size of the trade (optional).
- Optional referrer: string
  
  The address of the referrer (optional).
- Optional taker: string
  
  The address of the taker (optional).
Returns Promise<null | FillableQuote>
- The best fillable quote, or null if no quotes available.
- Defined in src/api/ordersAPI.ts:154

signQuote

signQuote(poolAddress, quote): Promise<QuoteWithSignature>
Signs a quote.
Parameters
- poolAddress: string
  
  The address of the pool.
- quote: QuoteSaltOptionalT
  
  The quote to be signed.
Returns Promise<QuoteWithSignature>
A promise that resolves to the signed quote.
- Defined in src/api/ordersAPI.ts:446

streamQuotes

streamQuotes(options, callback): Promise<void>
Streams quotes for the given options and executes a callback for the best quote.
Parameters
- options: {
      isBuy: boolean;
      minimumSize?: BigNumberish;
      poolAddress: string;
      referrer?: string;
      size: BigNumberish;
      taker?: string;
  }
  
  The options for the quotes stream:
  - isBuy: boolean
    
    Whether it's a buy or a sell.
  - Optional minimumSize?: BigNumberish
    
    The minimum size of the trade (optional).
  - poolAddress: string
    
    The address of the pool.
  - Optional referrer?: string
    
    The address of the referrer (optional).
  - size: BigNumberish
    
    The size of the trade.
  - Optional taker?: string
- callback: ((quote) => void)
  
  The callback to execute for the best quote.
  - - (quote): void
    - Parameters
      
      quote: FillableQuote
      
      Returns void
Returns Promise<void>
- Defined in src/api/ordersAPI.ts:215

`Private` tradeQuoteToFillable

tradeQuoteToFillable(poolAddress, size, quote, createdAt?, referrer?): Promise<FillableQuote>
Private
Converts a quote into a fillable quote, with additional properties required for execution.
Parameters
- poolAddress: string
  
  The address of the pool.
- size: BigNumberish
  
  The size of the trade.
- quote: QuoteWithSignatureT
  
  The quote to be converted.
- Optional createdAt: number
  
  The timestamp of the quote's creation (optional).
- Optional referrer: string
  
  The address of the referrer (optional).
Returns Promise<FillableQuote>
- A promise resolving to the fillable quote.
- Defined in src/api/ordersAPI.ts:83

`Static` calculateQuoteHash

calculateQuoteHash(quote, poolAddress, chainId): string
Calculates the hash of a quote. This is a static method.
Parameters
- quote: QuoteT
  
  The quote to hash.
- poolAddress: string
  
  The address of the pool.
- chainId: number
  
  The id of the chain.
Returns string
The calculated hash of the quote.
- Defined in src/api/ordersAPI.ts:515

Class OrdersAPI

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

premia: Premia

Returns OrdersAPI

Properties

Readonly premia

Methods

Private bestQuote

Parameters

quotes: OrderbookQuote[]

size: BigNumberish

Optional minimumSize: BigNumberish

Returns Promise<null | OrderbookQuote>

calculateQuoteHash

Method

Parameters

quote: QuoteT

poolAddress: string

Returns string

cancelAllStreams

Returns void

cancelQuoteStream

Returns void

isQuoteValid

Parameters

quote: OrderbookQuote

Optional size: BigNumberish

Optional throwError: boolean = false

Returns Promise<boolean>

publishQuote

Parameters

quote: QuoteWithSignatureT

Returns Promise<null | TransactionReceipt>

publishQuoteWithApiKey

Parameters

quote: QuoteWithSignatureT

Returns Promise<OrderbookQuote[]>

publishQuotes

Parameters

quotes: QuoteWithSignatureT[]

Returns Promise<null | TransactionReceipt>

publishQuotesWithApiKey

Parameters

quotes: QuoteWithSignatureT[]

Returns Promise<OrderbookQuote[]>

publishUnsignedQuote

Parameters

poolAddress: string

quote: QuoteSaltOptionalT

Returns Promise<null | TransactionReceipt>

publishUnsignedQuoteWithApiKey

Parameters

poolAddress: string

quote: QuoteSaltOptionalT

Returns Promise<OrderbookQuote[]>

publishUnsignedQuotes

Parameters

poolAddress: string

quotes: QuoteSaltOptionalT[]

Returns Promise<null | TransactionReceipt>

publishUnsignedQuotesWithApiKey

Parameters

poolAddress: string

quotes: QuoteSaltOptionalT[]

Returns Promise<OrderbookQuote[]>

quote

Parameters

poolAddress: string

size: BigNumberish

isBuy: boolean

Optional minimumSize: BigNumberish

Optional referrer: string

Optional taker: string

`Readonly` premia

`Private` bestQuote

`Optional` minimumSize: BigNumberish

`Optional` size: BigNumberish

`Optional` throwError: boolean = false

`Optional` minimumSize: BigNumberish

`Optional` referrer: string

`Optional` taker: string

options: {
isBuy: boolean;
minimumSize?: BigNumberish;
poolAddress: string;
referrer?: string;
size: BigNumberish;
taker?: string;
}

`Optional` minimumSize?: BigNumberish

`Optional` referrer?: string

`Optional` taker?: string

`Private` tradeQuoteToFillable

`Optional` createdAt: number

`Optional` referrer: string

`Static` calculateQuoteHash