Reya DEX REST API

This document provides comprehensive information about the trading API endpoints in the Reya DEX.

Base URL

Mainnet: https://api.reya.xyz/
Testnet: https://api-cronos.reya.xyz/

Table of Contents

  • Market Information

    • Get Markets

    • Get Market by ID

    • Get Markets Data

    • Get Market Data

    • Get Market Orders

    • Get Markets Configuration

  • Asset and Price Information

    • Get Assets

    • Get Prices

    • Get Price by Asset Pair ID

    • Get Pool Balance

  • Account and Wallet Information

    • Get Wallet Positions

    • Get Wallet Conditional Orders

    • Get Wallet Accounts

    • Get Wallet Account Balances

    • Get Wallet Orders

    • Get Wallet Configuration

  • Fee Configuration

    • Get Fee Tier Parameters

    • Get Global Fee Parameters

  • Candle Data

    • Get Historical Candles

Market Information

Get Markets

Returns a list of all markets, with some additional information for each market.

Endpoint: GET /api/trading/markets

Parameters: None

Response Fields:

Field
Type
Description

id

string

Unique identifier for the market

ticker

string

Trading pair symbol (e.g., "BTC-rUSD")

markPrice

number

Current mark price of the asset

isActive

boolean

Whether the market is currently active

maxLeverage

number

Maximum leverage allowed for this market

description

string

Description of the market

name

string

Always set to market

tickSizeDecimals

number

Number of decimal places for the tick size, e.g. 'tickSizeDecimals' 2 means tick size is 0.01

priority

number

Display priority for the market

Example Response:

[
  {
    "id": "2",
    "ticker": "BTC-rUSD",
    "markPrice": 43000,
    "isActive": true,
    "maxLeverage": 40,
    "description": "Perpetual LP Pool",
    "name": "Market",
    "tickSizeDecimals": 2,
    "priority": 0
  },
  {
    "id": "1",
    "ticker": "ETH-rUSD",
    "markPrice": 2000,
    "isActive": true,
    "maxLeverage": 25,
    "description": "Perpetual LP Pool",
    "name": "Market",
    "tickSizeDecimals": 2,
    "priority": 0
  },
  ...
]

Get Market by ID

Same as GetMarkets, but returns information about a specific market by its ID.

Endpoint: GET /api/trading/market/:marketId

Parameters:

  • marketId : The ID of the market

Get Markets Data

Returns data for all markets.

Endpoint: GET /api/trading/marketsData

Parameters: None

Response Fields:

Field
Type
Description

marketId

string

Unique identifier for the market

updatedAt

number

Timestamp of the last update, in milliseconds

longOI

number

Long open interest

shortOI

number

Short open interest

longSkewPercentage

number

Percentage of open interest that is long

shortSkewPercentage

number

Percentage of open interest that is short

openInterest

number

Total open interest

fundingRate

number

Current funding rate

last24hVolume

number

24-hour trading volume

maxAmountBaseLong

number

Maximum base amount for long positions

maxAmountBaseShort

number

Maximum base amount for short positions

maxAmountSizeLong

number

Maximum size for long positions

maxAmountSizeShort

number

Maximum size for short positions

priceChange24H

number

Absolute price change in the last 24 hours

priceChange24HPercentage

number

Percentage price change in the last 24 hours

poolPrice

number

Current pool price

oraclePrice

number

Current oracle price

pricesUpdatedAt

number

Timestamp when prices were last updated, in milliseconds

Example Response:

[
  {
    "marketId": "1",
    "updatedAt": 1747927089946,
    "longOI": 154.741,
    "shortOI": 154.706,
    "longSkewPercentage": 50,
    "shortSkewPercentage": 50,
    "openInterest": 154.741,
    "fundingRate": -0.000509373441021089,
    "last24hVolume": 917833.49891,
    "maxAmountBaseLong": 22358.141305674,
    "maxAmountBaseShort": 22358.071305674,
    "maxAmountSizeLong": 59601470.9708475,
    "maxAmountSizeShort": 59601284.3675466,
    "priceChange24H": 92.6272285500004,
    "priceChange24HPercentage": 3.59952086471522,
    "poolPrice": 2666.48166680625,
    "oraclePrice": 2666.48162040777,
    "pricesUpdatedAt": 1747927089597
  },
  {
    "marketId": "2",
    "updatedAt": 1747927288895,
    "longOI": 3.7879,
    "shortOI": 3.8273,
    "longSkewPercentage": 50,
    "shortSkewPercentage": 50,
    "openInterest": 3.8273,
    "fundingRate": 0.00193517321555959,
    "last24hVolume": 5618707.0551167,
    "maxAmountBaseLong": 857.066577292338,
    "maxAmountBaseShort": 857.145377292338,
    "maxAmountSizeLong": 95349246.104485,
    "maxAmountSizeShort": 95358012.6586736,
    "priceChange24H": 2303.70822774999,
    "priceChange24HPercentage": 2.11497590601892,
    "poolPrice": 111250.63101239,
    "oraclePrice": 111250.687672029,
    "pricesUpdatedAt": 1747927287804
  }
]

Get Market Data

Same as Get Markets Data, but returns data for a specific market by ID.

Endpoint: GET /api/trading/market/:marketId/data

Parameters:

  • marketId (path): The ID of the market

Get Market Orders

Returns orders for a specific market.

Endpoint: GET /api/trading/market/:marketId/orders

Parameters:

  • marketId (path): The ID of the market

  • before (query, optional): Pagination parameter, unique ID to fetch orders before

  • after (query, optional): Pagination parameter, unique ID to fetch orders after

  • direction (query, optional): Sorting direction, either 'asc' or 'desc'

  • limit (query, optional): Number of orders to return (default: 100, max: 100)

Response Fields:

Field
Type
Description

data

array

Array of order objects

» id

string

Unique identifier for the order

» market_id

string

ID of the market

» account_id

string

ID of the account

» executed_base

string

Executed base amount of the order

» fee

string

Fee paid for the order

» price

string

Execution price of the order

» is_match_order

boolean

Whether the order was a match order

» liquidation_type

string

Type of liquidation, if applicable (e.g., "-1" if not a liquidation)

» position_base

string

Base amount of the resulting position

» position_realized_pnl

string

Realized PnL for the position

» position_last_price

string

Last price for the position

» position_last_price_timestamp

string

Timestamp of the last price for the position

» position_funding_value

string

Funding value for the position

» position_base_multiplier

string

Base multiplier for the position

» position_adl_unwind_price

string

ADL unwind price for the position

» counterparty_account_id

string

Account ID of the counterparty

» counterparty_base

string

Base amount for the counterparty

» counterparty_realized_pnl

string

Realized PnL for the counterparty

» counterparty_last_price

string

Last price for the counterparty

» counterparty_last_price_timestamp

string

Timestamp of the last price for the counterparty

» counterparty_funding_value

string

Funding value for the counterparty

» counterparty_base_multiplier

string

Base multiplier for the counterparty

» counterparty_adl_unwind_price

string

ADL unwind price for the counterparty

» transaction_hash

string

Hash of the transaction

» block_timestamp

string

Timestamp of the block

» block_number

string

Number of the block

» unique_id

number

Unique sequential ID for the order event

» created_at

string

Creation timestamp (ISO 8601 format)

meta

object

Metadata for the order list

» limit

number

Number of orders requested per page

» count

number

Number of orders returned in the current response

» before

string

Cursor to fetch orders before this unique_id

» after

string

Cursor to fetch orders after this unique_id

Example Response:

{
  "data": [
    {
    "id": "0x6aaad743ca503ce6d5af7d6697a4ae5048e56dc4759453f10a91a80c72c2a3e8-8",
    "market_id": "2",
    "account_id": "13535",
    "executed_base": "1000000000000000",
    "fee": "44608",
    "price": "1.11521027e+23",
    "is_match_order": true,
    "liquidation_type": "-1",
    "position_base": "2000000000000000",
    "position_realized_pnl": "-239872695506513495539",
    "position_last_price": "1.113128725e+23",
    "position_last_price_timestamp": "1747928714",
    "position_funding_value": "5.744415068930922194348e+21",
    "position_base_multiplier": "1000000000000000000",
    "position_adl_unwind_price": "0",
    "counterparty_account_id": "2",
    "counterparty_base": "38400000000000000",
    "counterparty_realized_pnl": "4.882961090171428331359e+22",
    "counterparty_last_price": "1.10931637573604060913705e+23",
    "counterparty_last_price_timestamp": "1747927885",
    "counterparty_funding_value": "5.744415068930922194348e+21",
    "counterparty_base_multiplier": "1000000000000000000",
    "counterparty_adl_unwind_price": "0",
    "transaction_hash": "0x6aaad743ca503ce6d5af7d6697a4ae5048e56dc4759453f10a91a80c72c2a3e8",
    "block_timestamp": "1747928714",
    "block_number": "67782452",
    "unique_id": 6778245200008,
    "created_at": "2025-05-22T15:45:15.306Z"
    },
    {
      "id": "0xee6b97870ce5007629f0deea6b4fcf0023d9c811d0c3434802ced04c6ee4ffd0-8",
      "market_id": "2",
      "account_id": "41116",
      "executed_base": "-7500000000000000",
      "fee": "233284",
      "price": "1.11087614e+23",
      "is_match_order": true,
      "liquidation_type": "-1",
      "position_base": "0",
      "position_realized_pnl": "39438568000892260456",
      "position_last_price": "1.11169147e+23",
      "position_last_price_timestamp": "1747927453",
      "position_funding_value": "5.743926019031790294165e+21",
      "position_base_multiplier": "1000000000000000000",
      "position_adl_unwind_price": "0",
      "counterparty_account_id": "2",
      "counterparty_base": "39400000000000000",
      "counterparty_realized_pnl": "4.8829040780853913171371e+22",
      "counterparty_last_price": "1.10931637573604060913705e+23",
      "counterparty_last_price_timestamp": "1747927885",
      "counterparty_funding_value": "5.743926019031790294165e+21",
      "counterparty_base_multiplier": "1000000000000000000",
      "counterparty_adl_unwind_price": "0",
      "transaction_hash": "0xee6b97870ce5007629f0deea6b4fcf0023d9c811d0c3434802ced04c6ee4ffd0",
      "block_timestamp": "1747927885",
      "block_number": "67781953",
      "unique_id": 6778195300008,
      "created_at": "2025-05-22T15:31:25.748Z"
    }
  ],
  "meta": {
    "limit": 10,
    "count": 2,
    "before": null,
    "after": null
  }
}

Get Markets Configuration

Returns configuration information for all markets.

Endpoint: GET /api/trading/markets/configuration

Parameters: None

Response Fields:

Field
Type
Description

market_id

string

Unique identifier for the market configuration

risk_matrix_index

string

Index in the risk matrix

max_open_base

string

Maximum open base amount

velocity_multiplier

string

Velocity multiplier for the market

minimum_order_base

string

Minimum order base amount

base_spacing

string

Spacing for base amounts

price_spacing

string

Spacing for prices

oracle_node_id

string

Node ID for the oracle

mtm_window

string

Mark-to-Market (MTM) window in milliseconds

dutch_config_lambda

string

Lambda parameter for Dutch auction configuration

dutch_config_min_base

string

Minimum base for Dutch auction configuration

slippage_params_phi

string

Phi parameter for slippage

slippage_params_beta

string

Beta parameter for slippage

depth_factor

string

Depth factor for the market

max_exposure_factor

string

Maximum exposure factor

max_p_slippage

string

Maximum price slippage allowed

price_spread

string

Price spread for the market

volatility_index_multiplier

string

Multiplier for the volatility index

block_timestamp

string

Timestamp of the block when the configuration was recorded

block_number

string

Number of the block when the configuration was recorded

unique_id

number

Unique sequential ID for the configuration event

Example Response:

[
  {
    "market_id": "7",
    "risk_matrix_index": "0",
    "max_open_base": "4500000000000000000",
    "velocity_multiplier": "1e+22",
    "minimum_order_base": "10000000000000000",
    "base_spacing": "1000000000000000",
    "price_spacing": "1000000000000000",
    "oracle_node_id": "0xeba87760f9cb5f50279ee91edc07a7cfeba3e95b3d7340414fd297f7992ba59b",
    "mtm_window": "15768000000",
    "dutch_config_lambda": "1000000000000000000",
    "dutch_config_min_base": "110000000000000000",
    "slippage_params_phi": "0",
    "slippage_params_beta": "0",
    "depth_factor": "100000000000000000",
    "max_exposure_factor": "999000000000000000",
    "max_p_slippage": "100000000000000000",
    "price_spread": "0",
    "volatility_index_multiplier": "0",
    "block_timestamp": "1738689899",
    "block_number": "58212334",
    "unique_id": 5821233400007
  },
  {
    "market_id": "30",
    "risk_matrix_index": "0",
    "max_open_base": "1.9e+22",
    "velocity_multiplier": "0",
    "minimum_order_base": "1000000000000000000",
    "base_spacing": "100000000000000000",
    "price_spacing": "10000000000000",
    "oracle_node_id": "0x0021af309815a96ddf67eea50b8c13ac1698795eb578cd868552c7a841b28429",
    "mtm_window": "15768000000",
    "dutch_config_lambda": "1000000000000000000",
    "dutch_config_min_base": "110000000000000000",
    "slippage_params_phi": "0",
    "slippage_params_beta": "0",
    "depth_factor": "1e+21",
    "max_exposure_factor": "999000000000000000",
    "max_p_slippage": "100000000000000000",
    "price_spread": "0",
    "volatility_index_multiplier": "0",
    "block_timestamp": "1738689899",
    "block_number": "58212334",
    "unique_id": 5821233400030
  }
]

Asset and Price Information

Get Assets

Returns all assets supported by the platform.

Endpoint: GET /api/trading/assets

Response Fields:

Field
Type
Description

address

string

Contract address of the asset

name

string

Full name of the asset

short

string

Short symbol for the asset

createdAt

string

Timestamp when the asset was created

updatedAt

string

Timestamp when the asset was last updated

asset_price_contract_id

string

Contract ID for asset price

asset_price_usdc_contract_id

string

Contract ID for asset price in USDC

decimals

number

Number of decimals for the asset

Example Response:

[
  {
    "address": "0xaab18b45467ece5e47f85ca6d3dc4df2a350fd42",
    "name": "USDE",
    "short": "USDE",
    "createdAt": "2024-08-16T20:23:58.000Z",
    "updatedAt": "2024-08-16T20:23:58.000Z",
    "asset_price_contract_id": "0x0000000000000000000000000000000000000001",
    "asset_price_usdc_contract_id": "0x73ac348c40403ff1156a2f53ba57bccba2c63915",
    "decimals": 18
  },
  ...
]

Get Prices

Returns current prices for all symbols.

Endpoint: GET /api/trading/prices

Response Fields:

Field
Type
Description

marketId

number

ID of the market

oraclePrice

string

Price from oracle

poolPrice

string

Price from pool

price

string

Current price

updatedAt

number

Timestamp of the last update

Example Response:

[
  {
    "marketId": 1,
    "oraclePrice": "2531144014809193496986",
    "poolPrice": "2531142939673207966023",
    "price": "2530789301549999000000",
    "updatedAt": 1747834146575
  },
  ...
]

Get Price by Asset Pair ID

Same as Get Prices, but returns price information for a specific asset pair.

Endpoint: GET /api/trading/prices/:assetPairId

Parameters:

  • assetPairId (path): Identifier of the asset pair (e.g., ETHUSDMARK)

Get Pool Balance

Returns the balance information for a specific pool.

Endpoint: GET /api/trading/poolBalance/:poolId

Parameters:

  • poolId (path): Identifier of the pool

Response Fields:

Field
Type
Description

id

number

Unique identifier for the pool balance entry

pool_id

number

ID of the pool

timestamp

number

Timestamp of the balance record

value

string

Current value of the pool

apy

string

Annual percentage yield

share_price

string

Price per share

share_price_index

string

Share price index

Example Response:

{
  "id": 547606,
  "pool_id": 1,
  "timestamp": 1747834105656,
  "value": "17989265.69244052",
  "apy": "0.03072078779167425",
  "share_price": "1.041881093786799",
  "share_price_index": "33729011020.257646868833137"
}

Fee Configuration

Get Fee Tier Parameters

Returns parameters for all fee tiers.

Endpoint: GET /api/trading/feeTierParameters

Response Fields:

Field
Type
Description

tier_id

string

ID of the fee tier

taker_fee

string

Fee applied to takers

maker_fee

string

Fee applied to makers

volume

string

Volume threshold for the tier

Example Response:

[
  {
    "tier_id": "100",
    "taker_fee": "100000000000000",
    "maker_fee": "100000000000000",
    "volume": "0"
  },
  {
    "tier_id": "3",
    "taker_fee": "270000000000000",
    "maker_fee": "270000000000000",
    "volume": "10000000"
  }
]

Get Global Fee Parameters

Returns global fee parameters for the platform.

Endpoint: GET /api/trading/globalFeeParameters

Response Fields:

Field
Type
Description

og_discount

string

Discount for OG users

referee_discount

string

Discount for referees

referrer_rebate

string

Rebate for referrers

affiliate_referrer_rebate

string

Rebate for affiliate referrers

Example Response:

{
  "og_discount": "300000000000000000",
  "referee_discount": "100000000000000000",
  "referrer_rebate": "100000000000000000",
  "affiliate_referrer_rebate": "150000000000000000"
}

Account and Wallet Information

Get Wallet Positions

Returns all positions for a wallet.

Endpoint: GET /api/trading/wallet/:address/positions

Parameters:

  • address (path): Wallet address

Response Fields:

Field
Type
Description

market_id

string

Identifier for the market

account_id

string

Identifier for the account

base

string

Base amount of the position

quote

string

Quote amount of the position

leverage_hi

number

High leverage value

leverage_lo

number

Low leverage value

is_long

boolean

Whether the position is long

updated_block_number

string

Block number of the last update

updated_timestamp_ms

string

Timestamp of the last update (in milliseconds)

is_auto_exchange

boolean

Whether auto exchange is enabled

liquid_price

number

Liquidation price

mark_price

number

Current mark price

pnl

number

Profit and loss

pnl_perc

number

Profit and loss percentage

entry_price

number

Entry price of the position

leverage

number

Current leverage

unrealized_funding

number

Unrealized funding amount

Example Response:

[
  {
    "market_id": "1",
    "account_id": "7973",
    "base": "0",
    "realized_pnl": "-252947911897913931194",
    "last_price": "3.282153e+21",
    "last_price_timestamp": "1722773294",
    "funding_value": "236370407620718552816",
    "base_multiplier": "1000000000000000000",
    "adl_unwind_price": "0",
    "transaction_hash": "0x68901182d42077be9d1c6a4cdf3ebece582812b30159e52efae5855e0ba09787",
    "block_timestamp": "1722820382",
    "block_number": "17179690",
    "unique_id": 1717969000012
  }
]

Get Wallet Conditional Orders

Returns all pending conditional orders for a wallet.

Endpoint: GET /api/trading/wallet/:address/conditionalOrders

Parameters:

  • address (path): Wallet address

Response Fields:

Field
Type
Description

id

string

Unique identifier for the order

account_id

string

Identifier for the account

market_id

string

Identifier for the market

order_type

string

Type of order (e.g., "Limit Order")

is_long

boolean

Whether the position is long

trigger_price

number

Price at which the order is triggered

order_base

string

Base amount of the order

exchange_id

number

Exchange identifier

inputs

string

Order inputs in hex format

counterparty_account_id

number

Counterparty account ID

reya_chain_id

number

Reya chain identifier

deadline

number

Order deadline timestamp

signer_address

string

Address of the signer

nonce

string

Unique nonce for the order

signature

string

Cryptographic signature

status

string

Current status of the order (e.g., "pending")

creation_timestamp_ms

number

Creation timestamp (in milliseconds)

last_update_timestamp_ms

number

Last update timestamp (in milliseconds)

transaction_hash

string

Hash of the transaction, or null if not yet processed

Example Response:

[
  {
    "id": "a77d7040-c079-4d48-b78a-4e9d682fd85d",
    "account_id": "95681",
    "market_id": "2",
    "order_type": "Stop Loss",
    "is_long": false,
    "trigger_price": 110000,
    "order_base": "0",
    "status": "pending",
    "creation_timestamp_ms": 1747943630008,
    "last_update_timestamp_ms": 1747943630008,
    "transaction_hash": null
  }
]

Get Wallet Account Balances

Return balances for a all accounts belonging to a wallet

Endpoint: GET /api/trading/wallet/:address/accounts/balances

Parameters:

  • address (path): Wallet address

Response Fields:

Field
Type
Description

account_id

string

Identifier for the account

collateral

string

Collateral address

balance

number

balance

Example Response:

[
  {
    "account_id": "95681",
    "collateral": "0x124c0D60D2ED42e6EF7c6018363B3d669242F822",
    "balance": "25100076000000000000"
  }
]

Get Wallet Configuration

Returns configuration for a specific account owner.

Endpoint: GET /api/trading/wallet/:address/configuration

Parameters:

  • address (path): Wallet address

Response Fields:

Field
Type
Description

tier_id

string

ID of the fee tier

og_status

boolean

Status of OG users

referee_status

boolean

Status of referees

affiliate_status

boolean

Status of affiliates

main_account_id

string

ID of the main account

Example Response:

{
  "tier_id": "0",
  "og_status": true,
  "referee_status": false,
  "affiliate_status": false,
  "main_account_id": "7973"
}

Get Wallet Orders

Returns all orders for a wallet, with pagination.

Endpoint: GET /api/trading/wallet/:address/orders

Parameters:

  • address (path): Wallet address

  • limit (query, optional): Number of orders to return (default: 100)

  • before (query, optional): Return orders before this ID for pagination

  • after (query, optional): Return orders after this ID for pagination

Response Fields:

Field
Type
Description

data

array

Array of order objects

» id

string

Unique identifier for the order

» market_id

string

Identifier for the market

» account_id

string

Identifier for the account

» executed_base

string

Base amount executed

» fee

string

Fee paid for the order

» price

string

Order price

» is_match_order

boolean

Whether the order is a match order

» liquidation_type

string

Type of liquidation, if applicable (e.g., "-1" if not a liquidation)

» position_base

string

Position base amount after the order

» position_realized_pnl

string

Realized PnL for the position after this order

» position_last_price

string

Last price for the position after this order

» position_last_price_timestamp

string

Timestamp of the last price for the position

» position_funding_value

string

Funding value for the position

» position_base_multiplier

string

Base multiplier for the position

» position_adl_unwind_price

string

ADL unwind price for the position

» counterparty_account_id

string

Account ID of the counterparty

» counterparty_base

string

Base amount for the counterparty

» counterparty_realized_pnl

string

Realized PnL for the counterparty

» counterparty_last_price

string

Last price for the counterparty

» counterparty_last_price_timestamp

string

Timestamp of the last price for the counterparty

» counterparty_funding_value

string

Funding value for the counterparty

» counterparty_base_multiplier

string

Base multiplier for the counterparty

» counterparty_adl_unwind_price

string

ADL unwind price for the counterparty

» transaction_hash

string

Hash of the transaction

» block_timestamp

string

Timestamp of the block

» block_number

string

Block number

» unique_id

number

Unique identifier for the event

» created_at

string

Creation timestamp

meta

object

Metadata for pagination

» limit

number

Number of results returned

» count

number

Total count of results in this batch

» before

number

ID to use for fetching previous page

» after

number

ID to use for fetching next page

Example Response:

{
  "data": [
    {
      "id": "0xe7a2415f615c32fdb309738f7786e40cb5c2ff31bd5229d527cbb87a9953e1bf-8",
      "market_id": "2",
      "account_id": "95681",
      "executed_base": "20600000000000000",
      "fee": "801813",
      "price": "1.11208696e+23",
      "is_match_order": true,
      "liquidation_type": "-1",
      "position_base": "20600000000000000",
      "position_realized_pnl": "-18749657582419440095",
      "position_last_price": "1.11208696e+23",
      "position_last_price_timestamp": "1747943611",
      "position_funding_value": "5.753090050869636920185e+21",
      "position_base_multiplier": "1000000000000000000",
      "position_adl_unwind_price": "0",
      "counterparty_account_id": "2",
      "counterparty_base": "-77900000000000000",
      "counterparty_realized_pnl": "4.8843950429623853993507e+22",
      "counterparty_last_price": "1.11564219456087119420629e+23",
      "counterparty_last_price_timestamp": "1747943611",
      "counterparty_funding_value": "5.753090050869636920185e+21",
      "counterparty_base_multiplier": "1000000000000000000",
      "counterparty_adl_unwind_price": "0",
      "transaction_hash": "0xe7a2415f615c32fdb309738f7786e40cb5c2ff31bd5229d527cbb87a9953e1bf",
      "block_timestamp": "1747943611",
      "block_number": "67791450",
      "unique_id": 6779145000008,
      "created_at": "2025-05-22T19:53:31.545Z"
    }
  ],
  "meta": {
    "limit": 100,
    "count": 100,
    "before": 6779145000008,
    "after": 6717460200009
  }
}

Candle Data

Get Historical Candles

Returns historical candle data for a specific asset pair and resolution.

Endpoint: GET /candles/:assetPairId/:resolution

Path Parameters:

Parameter
Type
Description

assetPairId

string

The ID of the asset pair (e.g., "ETH-rUSD")

resolution

string

The candle resolution (e.g., "1", "5", "15", "60", "240", "1D")

Query Parameters:

Parameter
Type
Description

from

number

Optional. Unix timestamp (in seconds) for the start of the historical data range. Defaults to 200 candles back from to if to is provided, or 200 candles back from now.

to

number

Optional. Unix timestamp (in seconds) for the end of the historical data range. Defaults to the current time.

Response Fields:

Field
Type
Description

t

number[]

Array of timestamps for each candle (epoch seconds)

o

number[]

Array of opening prices for each candle

h

number[]

Array of highest prices for each candle

l

number[]

Array of lowest prices for each candle

c

number[]

Array of closing prices for each candle

Example Response:

{
  "t": [1747804140, 1747804200, 1747804260, 1747804320, 1747804380],
  "o": [2557.997733549999, 2555.386924449999, 2560.118390749999, 2560.438506749999, 2558.67797405],
  "h": [2557.997733549999, 2560.698570549999, 2560.728578149999, 2560.438506749999, 2559.06808615],
  "l": [2554.636691949999, 2553.436319949999, 2559.368198649999, 2558.908027049999, 2558.027788949999],
  "c": [2555.386924449999, 2560.118390749999, 2560.438506749999, 2558.67797405, 2558.027788949999]
}
PreviousReya Chain Points: FAQsNextReya DEX WebSocket

Last updated