Reference Data

Market definitions, global parameters, liquidity parameters, etc.

Get market definitions

get

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

/marketDefinitions

Responses

200

List of market definitions

application/json

symbolstringRequired

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

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

marketIdintegerRequired

Numerical identifier for each market, only needed to generate signatures

Example: 1747927089946

minOrderQtystringRequiredExample: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

qtyStepSizestringRequired

Minimum size increment

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

tickSizestringRequired

Minimum price increment

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

liquidationMarginParameterstringRequired

Minimum percentage of notional that needs to be covered to avoid liquidation procedures for a given market; below this value, your account is subject to liquidation procedures. When cross margining, all requirements across markets are covered by the same balance, and all positions are subject to liquidations.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

initialMarginParameterstringRequired

Minimum percentage of notional that needs to be covered post trade; if the account does not satisfy this requirement, trades will not get executed.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

maxLeverageintegerRequired

Maximum leverage allowed

Example: 1747927089946

oiCapstringRequired

Maximum one-sided open interest in units for a given market.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/marketDefinitions

HTTPcURLJavaScriptPython

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

[
  {
    "symbol": "BTCRUSDPERP",
    "marketId": 1747927089946,
    "minOrderQty": "1.0",
    "qtyStepSize": "1.0",
    "tickSize": "1.0",
    "liquidationMarginParameter": "1.0",
    "initialMarginParameter": "1.0",
    "maxLeverage": 1747927089946,
    "oiCap": "1.0",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get spot market definitions

get

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

/spotMarketDefinitions

Responses

200

List of spot market definitions

application/json

symbolstringRequired

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

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

marketIdintegerRequired

Numerical identifier for each spot market

Example: 1747927089946

baseAssetstringRequired

Base asset symbol

Example: ETH

quoteAssetstringRequired

Quote asset symbol

Example: RUSD

minOrderQtystringRequired

Minimum order quantity (base asset)

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

qtyStepSizestringRequired

Minimum size increment (base asset)

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

tickSizestringRequired

Minimum price increment

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/spotMarketDefinitions

HTTPcURLJavaScriptPython

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

[
  {
    "symbol": "BTCRUSDPERP",
    "marketId": 1747927089946,
    "baseAsset": "ETH",
    "quoteAsset": "RUSD",
    "minOrderQty": "1.0",
    "qtyStepSize": "1.0",
    "tickSize": "1.0",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get asset definitions

get

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

/assetDefinitions

Responses

200

List of asset definitions

application/json

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

spotMarketSymbolstringOptional

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

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

priceHaircutstringRequired

Notional discount to the value of a collateral when used to satisfy the margin requirements; it does not imply any token conversion, but is rather an accounting adjustment.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

liquidationDiscountstringRequired

Discount in the token price when liquidating collateral.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

statusstring · enumRequired

Status of asset (ENABLED = deposits and withdrawals allowed, WITHDRAWAL_ONLY = only withdrawals allowed)

Example: ENABLEDPossible values:

decimalsintegerRequired

Number of decimal places for record keeping amounts of this asset (e.g. 18 for ETH, 6 for RUSD)

Example: 1747927089946

displayDecimalsintegerRequired

Number of decimal places shown for display purposes in frontends

Example: 1747927089946

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/assetDefinitions

HTTPcURLJavaScriptPython

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

[
  {
    "asset": "BTCRUSDPERP",
    "spotMarketSymbol": "BTCRUSDPERP",
    "priceHaircut": "1.0",
    "liquidationDiscount": "1.0",
    "status": "ENABLED",
    "decimals": 1747927089946,
    "displayDecimals": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get liquidity parameters

get

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

/liquidityParameters

Responses

200

List of liquidity parameters

application/json

symbolstringRequired

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

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

depthstringRequired

Parameter determining the liquidity distribution along the AMM pricing curve, in particular expanding or contracting the max exposure parameter that would otherwise be determined by the capital available.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

velocityMultiplierstringRequired

Parameter determining the sensitivity of the dynamic funding rate to the size of the imbalances; higher multiplier means that the funding rate will diverge faster, all else being equal.

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/liquidityParameters

HTTPcURLJavaScriptPython

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

[
  {
    "symbol": "BTCRUSDPERP",
    "depth": "1.0",
    "velocityMultiplier": "1.0",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get global fee parameters

get

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

/globalFeeParameters

Responses

200

Global fee parameters

application/json

ogDiscountstringRequired

OG user discount

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

refereeDiscountstringRequired

Referee discount

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

referrerRebatestringRequired

Referrer rebate

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

affiliateReferrerRebatestringRequired

Affiliate referrer rebate

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/globalFeeParameters

HTTPcURLJavaScriptPython

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

{
  "ogDiscount": "1.0",
  "refereeDiscount": "1.0",
  "referrerRebate": "1.0",
  "affiliateReferrerRebate": "1.0",
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get fee tiers

get

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

/feeTiers

Responses

200

List of fee tier parameters

application/json

tierIdintegerRequiredExample: 1747927089946

takerFeestringRequired

Taker fee rate (fee will be qty * takerFee)

Example: 43000.00Pattern: ^-?\d+(\.\d+)?([eE][+-]?\d+)?$

makerFeestringRequired

Maker fee rate (fee will be qty * makerFee)

Example: 43000.00Pattern: ^-?\d+(\.\d+)?([eE][+-]?\d+)?$

volume14dstringRequired

14-day volume level required this fee tier to be applied to a wallet

Example: 1.0Pattern: ^\d+(\.\d+)?([eE][+-]?\d+)?$

tierTypestring · enumRequired

Fee tier type (REGULAR = Standard tier, VIP = VIP tier)

Possible values:

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/feeTiers

HTTPcURLJavaScriptPython

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

[
  {
    "tierId": 1747927089946,
    "takerFee": "43000.00",
    "makerFee": "43000.00",
    "volume14d": "1.0",
    "tierType": "REGULAR",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]