Market Data

Prices, market-level trades, depth, candles, etc.

Get market summaries

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/markets/summary

Statistics and throttled market data for all markets. Recalculated every 0.5s

Responses

200

List of market summaries

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/markets/summary

HTTPcURLJavaScriptPython

GET /v2/markets/summary HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "symbol": "BTCRUSDPERP",
    "updatedAt": 1747927089946,
    "longOiQty": "1.0",
    "shortOiQty": "1.0",
    "oiQty": "1.0",
    "fundingRate": "43000.00",
    "longFundingValue": "43000.00",
    "shortFundingValue": "43000.00",
    "fundingRateVelocity": "43000.00",
    "volume24h": "1.0",
    "pxChange24h": "43000.00",
    "throttledOraclePrice": "43000.00",
    "throttledPoolPrice": "43000.00",
    "pricesUpdatedAt": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get market summary

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/market/{symbol}/summary

Statistics and throttled data for a specific market. Recalculated every 0.5s

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

Responses

200

Market summary

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/market/{symbol}/summary

HTTPcURLJavaScriptPython

GET /v2/market/{symbol}/summary HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "symbol": "BTCRUSDPERP",
  "updatedAt": 1747927089946,
  "longOiQty": "1.0",
  "shortOiQty": "1.0",
  "oiQty": "1.0",
  "fundingRate": "43000.00",
  "longFundingValue": "43000.00",
  "shortFundingValue": "43000.00",
  "fundingRateVelocity": "43000.00",
  "volume24h": "1.0",
  "pxChange24h": "43000.00",
  "throttledOraclePrice": "43000.00",
  "throttledPoolPrice": "43000.00",
  "pricesUpdatedAt": 1747927089946,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get all prices

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/prices

Responses

200

List of prices

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/prices

HTTPcURLJavaScriptPython

GET /v2/prices HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "symbol": "BTCRUSDPERP",
    "oraclePrice": "43000.00",
    "poolPrice": "43000.00",
    "updatedAt": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get price by symbol

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/prices/{symbol}

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

Responses

200

Price information

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/prices/{symbol}

HTTPcURLJavaScriptPython

GET /v2/prices/{symbol} HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "symbol": "BTCRUSDPERP",
  "oraclePrice": "43000.00",
  "poolPrice": "43000.00",
  "updatedAt": 1747927089946,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get perp executions for market

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/market/{symbol}/perpExecutions

Returns up to 100 perp executions for a given market.

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

Query parameters

startTimeintegerOptional

Return results after this sequence number (for pagination)

Example: 1747927089946

endTimeintegerOptional

Return results before this sequence number (for pagination)

Example: 1747927089946

Responses

200

List of perp executions

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/market/{symbol}/perpExecutions

HTTPcURLJavaScriptPython

GET /v2/market/{symbol}/perpExecutions HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "data": [
    {
      "exchangeId": 1747927089946,
      "symbol": "BTCRUSDPERP",
      "accountId": 1747927089946,
      "qty": "1.0",
      "side": "B",
      "price": "43000.00",
      "fee": "43000.00",
      "type": "ORDER_MATCH",
      "timestamp": 1747927089946,
      "sequenceNumber": 1747927089946,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "meta": {
    "limit": 1747927089946,
    "count": 1747927089946,
    "endTime": 1747927089946,
    "startTime": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get market depth snapshot

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/market/{symbol}/depth

Returns an L2 order book snapshot with aggregated price levels for the specified market.

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

Responses

200

Depth snapshot

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/market/{symbol}/depth

HTTPcURLJavaScriptPython

GET /v2/market/{symbol}/depth HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "symbol": "BTCRUSDPERP",
  "type": "SNAPSHOT",
  "bids": [
    {
      "px": "43000.00",
      "qty": "1.0",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "asks": [
    {
      "px": "43000.00",
      "qty": "1.0",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "updatedAt": 1747927089946,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get spot executions for market

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/market/{symbol}/spotExecutions

Returns up to 100 spot executions for a given market.

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

Query parameters

startTimeintegerOptional

Return results after this sequence number (for pagination)

Example: 1747927089946

endTimeintegerOptional

Return results before this sequence number (for pagination)

Example: 1747927089946

Responses

200

List of spot executions

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/market/{symbol}/spotExecutions

HTTPcURLJavaScriptPython

GET /v2/market/{symbol}/spotExecutions HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "data": [
    {
      "exchangeId": 1747927089946,
      "symbol": "BTCRUSDPERP",
      "accountId": 1747927089946,
      "makerAccountId": 1747927089946,
      "orderId": "63552420354981888",
      "makerOrderId": "63552420037263360",
      "side": "B",
      "qty": "1.0",
      "price": "43000.00",
      "fee": "43000.00",
      "type": "ORDER_MATCH",
      "timestamp": 1747927089946,
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "meta": {
    "limit": 1747927089946,
    "count": 1747927089946,
    "endTime": 1747927089946,
    "startTime": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get historical candles

get

https://api.reya.xyz/v2https://api-test.reya.xyz/v2

/candleHistory/{symbol}/{resolution}

Returns up to 200 candles for a given market, sorted by time in descending order, and ending at the specified end time.

Path parameters

symbolstringRequired

Trading symbol (e.g., BTCRUSDPERP, WETHRUSD)

Example: BTCRUSDPERPPattern: ^[A-Za-z0-9]+$

resolutionstring · enumRequired

Candle resolution

Example: 1mPossible values:

Query parameters

endTimeintegerOptional

Return results before this sequence number (for pagination)

Example: 1747927089946

Responses

200

Historical candle data

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/candleHistory/{symbol}/{resolution}

HTTPcURLJavaScriptPython

GET /v2/candleHistory/{symbol}/{resolution} HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "t": [
    1747804140,
    1747804200,
    1747804260
  ],
  "o": [
    "2557.997",
    "2555.386",
    "2560.118"
  ],
  "h": [
    "2558.000",
    "2560.699",
    "2560.729"
  ],
  "l": [
    "2554.637",
    "2553.436",
    "2559.368"
  ],
  "c": [
    "2555.387",
    "2560.118",
    "2560.439"
  ],
  "ANY_ADDITIONAL_PROPERTY": "anything"
}