Get market data

GET

/iou/market_data/{base}/{counter}

Retrieve market data for a given currency pair over time.

Parameters

Path Parameters

base

required

string

• Base currency of the pair as issuer address, followed by _ and the currency code. (Or XAH with no issuer)

• Examples: XAH or rEvernodee8dJLaFsujS6q1EiXvZYmHXr8_EVR

counter

required

string

• Counter currency of the pair as issuer address, followed by _ and a currency code. (Or XAH with no issuer)

• Examples: XAH or rEvernodee8dJLaFsujS6q1EiXvZYmHXr8_EVR

Query Parameters

interval

required

string

• Aggregation interval. Possible values are: s,m,h,d,M,y.

• Example: 1d to aggregate data by 1 day intervals

start

string format: date-time

• Filters results no earlier than the specified date time.

• Format: ‘1970-01-01T00:00:00Z’

end

string format: date-time

• Filters results no later than the specified date time.

• Format: ‘1970-01-01T00:00:00Z’

min_base_volume

number

• Only include exchanges with the requested minimal base volume.

min_counter_volume

number

• Only include exchanges with the requested minimal counter volume.

descending

boolean

• If true, return results in reverse chronological order by timestamp.

skip

number

• Skip a defined number of entries.

limit

number

• Limit the entries in the response.

• Higher values result in slower response times!

Responses

200

Success response

• base_volume = The total volume of the base currency in this interval

• base_volume_buy = The buy volume of the base currency in this interval

• base_volume_sell = The sell volume of the base currency in this interval

• counter_volume = The total traded volume of the counter currency in this interval

• counter_volume_buy = The buy volume of the counter currency in this interval

• counter_volume_sell = The sell volume of the counter currency in this interval

• open = The rate at the start of this interval

• high = The highest rate in this interval

• low = The lowest rate in this interval

• close = The rate at the end of this interval

• exchanges = Total number of exchanges in this interval

• unique_buyers = Total number of unique accounts buying

• unique_sellers = Total number of unique accounts selling

• timestamp = Start time of this interval

Array<object>

MarketData

object

base_volume

required

number format: float

base_volume_buy

required

number format: float

base_volume_sell

required

number format: float

counter_volume

required

number format: float

counter_volume_buy

required

number format: float

counter_volume_sell

required

number format: float

open

required

number format: float

high

required

number format: float

low

required

number format: float

close

required

number format: float

exchanges

required

number format: integer

unique_buyers

required

number format: integer

unique_sellers

required

number format: integer

timestamp

required

string format: date-time

400

Query input malformed

ValidationError

object

message

required

string

code

string

path

string

Headers

x-ratelimit-limit

integer

Maximum number of requests in the rate limit window.

x-ratelimit-remaining

integer

Number of remaining request in current rate limit window.

x-ratelimit-reset

integer

The seconds until the current rate limit window resets.

429

Too Many Requests

Headers

x-ratelimit-limit

integer

Maximum number of requests in the rate limit window.

x-ratelimit-remaining

integer

Number of remaining request in current rate limit window.

x-ratelimit-reset

integer

The seconds until the current rate limit window resets.