Documentation GitHub npm

Class

TradesCallBuilder

(private) TradesCallBuilder(serverUrl)

Creates a new TradesCallBuilder pointed to server defined by serverUrl.

Do not create this object directly, use Horizon.Server#trades.

Constructor

# private new TradesCallBuilder(serverUrl)

Parameters:
Name Type Description
serverUrl string

serverUrl Horizon server URL.
See:

View Source lib/horizon/trades_call_builder.js, line 21

Extends

Members

# private _handleNetworkError

Overrides:

View Source lib/horizon/call_builder.d.ts, line 127

# private _parseRecord

Given the json response, find and convert each link into a function that calls that link.

Overrides:

View Source lib/horizon/call_builder.d.ts, line 106

# private _parseResponse

Overrides:

View Source lib/horizon/call_builder.d.ts, line 113

# private _requestFnForLink

Convert a link object to a function that fetches that link.

Overrides:

View Source lib/horizon/call_builder.d.ts, line 97

# private _toCollectionPage

Overrides:

View Source lib/horizon/call_builder.d.ts, line 120

# private checkFilter

Overrides:

View Source lib/horizon/call_builder.d.ts, line 87

Methods

# call() → {Promise}

Triggers a HTTP request using this builder's current configuration.

Overrides:

View Source lib/horizon/call_builder.d.ts, line 14

a Promise that resolves to the server's response.

Promise

# cursor(cursor) → {object}

Sets cursor parameter for the current call. Returns the CallBuilder object on which this method has been called.

Parameters:
Name Type Description
cursor string

A cursor is a value that points to a specific location in a collection of resources.
Overrides:
See:

View Source lib/horizon/call_builder.d.ts, line 35

current CallBuilder instance

object

# forAccount(accountId) → {TradesCallBuilder}

Filter trades for a specific account

Parameters:
Name Type Description
accountId string

For example: GBYTR4MC5JAX4ALGUBJD7EIKZVM7CUGWKXIUJMRSMK573XH2O7VAK3SR
See:

View Source lib/horizon/trades_call_builder.js, line 77

current TradesCallBuilder instance

TradesCallBuilder

# forAssetPair(base, counter) → {TradesCallBuilder}

Filter trades for a specific asset pair (orderbook)

Parameters:
Name Type Description
base Asset

asset
counter Asset

asset

View Source lib/horizon/trades_call_builder.js, line 33

current TradesCallBuilder instance

TradesCallBuilder

# protected forEndpoint(endpoint, param) → {CallBuilder}

A helper method to craft queries to "neighbor" endpoints.

For example, we have an /effects suffix endpoint on many different "root" endpoints, such as /transactions/:id and /accounts/:id. So, it's helpful to be able to conveniently create queries to the /accounts/:id/effects endpoint:

this.forEndpoint("accounts", accountId)`.

Parameters:
Name Type Description
endpoint string

neighbor endpoint in question, like /operations
param string

filter parameter, like an operation ID
Overrides:

View Source lib/horizon/call_builder.d.ts, line 81

this CallBuilder instance

CallBuilder

# forLiquidityPool(liquidityPoolId) → {TradesCallBuilder}

Filter trades for a specific liquidity pool

Parameters:
Name Type Description
liquidityPoolId string

For example: 3b476aff8a406a6ec3b61d5c038009cef85f2ddfaf616822dc4fec92845149b4
See:

View Source lib/horizon/trades_call_builder.js, line 87

current TradesCallBuilder instance

TradesCallBuilder

# forOffer(offerId) → {TradesCallBuilder}

Filter trades for a specific offer

Parameters:
Name Type Description
offerId string

ID of the offer

View Source lib/horizon/trades_call_builder.js, line 56

current TradesCallBuilder instance

TradesCallBuilder

# forType(tradeType) → {TradesCallBuilder}

Filter trades by a specific type.

Parameters:
Name Type Description
tradeType ServerApi.TradeType

the trade type to filter by.

View Source lib/horizon/trades_call_builder.js, line 66

current TradesCallBuilder instance.

TradesCallBuilder

# join("include") → {object}

Sets join parameter for the current call. The join parameter includes the requested resource in the response. Currently, the only valid value for the parameter is transactions and is only supported on the operations and payments endpoints. The response will include a transaction field for each operation in the response.

Parameters:
Name Type Description
"include"

join Records to be included in the response.
Overrides:

View Source lib/horizon/call_builder.d.ts, line 63

current CallBuilder instance.

object

# limit(recordsNumber) → {object}

Sets limit parameter for the current call. Returns the CallBuilder object on which this method has been called.

Parameters:
Name Type Description
recordsNumber number

Number of records the server should return.
Overrides:
See:

View Source lib/horizon/call_builder.d.ts, line 43

current CallBuilder instance

object

# order(direction) → {object}

Sets order parameter for the current call. Returns the CallBuilder object on which this method has been called.

Parameters:
Name Type Description
direction "asc" | "desc"

Sort direction
Overrides:

View Source lib/horizon/call_builder.d.ts, line 50

current CallBuilder instance

object

# stream(optionsopt) → {function}

Creates an EventSource that listens for incoming messages from the server. To stop listening for new events call the function returned by this method.

Parameters:
Name Type Attributes Description
options object <optional>

EventSource options.
onmessage function <optional>

Callback function to handle incoming messages.
onerror function <optional>

Callback function to handle errors.
reconnectTimeout number <optional>

Custom stream connection timeout in ms, default is 15 seconds.
Overrides:
See:

View Source lib/horizon/call_builder.d.ts, line 27

Close function. Run to close the connection and stop listening for new events.

function