Skip to main content

List Trade Aggregations REST API Endpoint

Displays trade data based on filters set in the arguments. This is done by dividing a given time range into segments and aggregating statistics, for a given asset pair (base, counter) over each of these segments

Updated on
Sep 05, 2025

Query Parameters

start_time
integer

The lower time boundary represented as milliseconds since epoch

end_time
integer

The upper time boundary represented as milliseconds since epoch

resolution
integer

The segment duration represented as milliseconds. Supported values are 1 minute (60000), 5 minutes (300000), 15 minutes (900000), 1 hour (3600000), 1 day (86400000) and 1 week (604800000)

offset
integer

Segments can be offset using this parameter. Expressed in milliseconds. Can only be used if the resolution is greater than 1 hour. Value must be in whole hours, less than the provided resolution, and less than 24 hours

base_asset_type
string
REQUIRED

The type for the base asset. Either 'native', 'credit_alphanum4', or 'credit_alphanum12'

base_asset_issuer
string

The Stellar address of the issuer of the base asset. Required if the base_asset_type is not 'native'

base_asset_code
string

The code for the base asset. Required if the base_asset_type is not 'native'

counter_asset_type
string
REQUIRED

The type for the counter asset. Either 'native', 'credit_alphanum4', or 'credit_alphanum12'

counter_asset_issuer
string

The Stellar address of the issuer of the counter asset. Required if the counter_asset_type is not 'native'

counter_asset_code
string

The code for the counter asset. Required if the counter_asset_type is not 'native'

order
string

The order of the returned data. The possible value includes ascending and descending order

limit
integer

The maximum number of records to return

Returns

_links
object

The links related to the trade aggregation data

self
object

The self-reference link

href
string

The URL for self-reference

next
object

Link to the next set of data

href
string

The URL for next set of data

prev
object

Link to the previous set of data

href
string

The URL for previous set of data

_embedded
object

The embedded trade aggregation records

records
array

An array of trade aggregation records

timestamp
string

The start time for this trade aggregation

trade_count
string

The total number of trades aggregated

base_volume
string

The total volume of the base asset traded

counter_volume
string

The total volume of the counter asset traded

avg
string

The average price for this time period

high
string

The highest price for this time period

high_r
object

The highest price as a rational number

n
integer

The numerator

d
integer

The denominator

low
string

The lowest price for this time period

low_r
object

The lowest price as a rational number

n
integer

The numerator

d
integer

The denominator

open
string

The opening price for this time period

open_r
object

The opening price as a rational number

n
integer

The numerator

d
integer

The denominator

close
string

The closing price for this time period

close_r
object

The closing price as a rational number

n
integer

The numerator

d
integer

The denominator

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free