Wallet Data

Accounts, positions, trades, etc.

Get wallet accounts

get

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

/wallet/{address}/accounts

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

List of accounts

application/json

accountIdintegerRequiredExample: 1747927089946

namestringRequiredExample: Margin Account 1

typestring · enumRequired

SPOT = account that can only trade spot, MAINPERP = main perp account, SUBPERP = sub perp account

Possible values:

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/accounts

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/accounts HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "accountId": 1747927089946,
    "name": "Margin Account 1",
    "type": "MAINPERP",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get wallet spot execution busts

get

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

/wallet/{address}/spotExecutionBusts

Returns up to 100 spot execution busts (failed spot fills) for a given wallet.

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

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 execution busts

application/json

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/spotExecutionBusts

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/spotExecutionBusts HTTP/1.1
Host: api.reya.xyz
Accept: */*

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

Get wallet perp executions

get

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

/wallet/{address}/perpExecutions

Returns up to 100 perp executions for a given wallet.

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

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 perpetual executions

application/json

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/perpExecutions

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/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 wallet spot executions

get

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

/wallet/{address}/spotExecutions

Returns up to 100 spot executions for a given wallet.

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

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

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/spotExecutions

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/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 wallet positions

get

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

/wallet/{address}/positions

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

List of positions

application/json

exchangeIdintegerRequiredExample: 1747927089946

symbolstringRequired

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

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

accountIdintegerRequiredExample: 1747927089946

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

sidestring · enumRequired

Order side (B = Buy/Bid, A = Ask/Sell)

Possible values:

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

avgEntryFundingValuestringRequired

Average of funding values at the entry times of currently open exposure, which serves as a baseline from which to compute the accrued funding in the position: units x (fundingValue - avgEntryFundingValue)

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

lastTradeSequenceNumberintegerRequired

Sequence number of last execution taken into account for the position.

Example: 1747927089946

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/positions

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/positions HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "exchangeId": 1747927089946,
    "symbol": "BTCRUSDPERP",
    "accountId": 1747927089946,
    "qty": "1.0",
    "side": "B",
    "avgEntryPrice": "43000.00",
    "avgEntryFundingValue": "43000.00",
    "lastTradeSequenceNumber": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get wallet account balances

get

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

/wallet/{address}/accountBalances

Returns all account real balances for a wallet.

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

List of account balances

application/json

accountIdintegerRequiredExample: 1747927089946

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

realBalancestringRequired

Sum of account net deposits (transfers, deposits and withdrawals) and realized pnl from closed positions. Realized pnl only applies to RUSD given it is the only settlement asset

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

balanceDEPRECATEDstringRequired

Sum of account net deposits (transfers, deposits and withdrawals). This field is deprecated and will be removed in a future release

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

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/accountBalances

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/accountBalances HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "accountId": 1747927089946,
    "asset": "BTCRUSDPERP",
    "realBalance": "43000.00",
    "balanceDEPRECATED": "43000.00",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get wallet open orders

get

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

/wallet/{address}/openOrders

Returns all pending orders for a wallet.

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

List of open orders

application/json

exchangeIdintegerRequiredExample: 1747927089946

symbolstringRequired

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

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

accountIdintegerRequiredExample: 1747927089946

orderIdstringRequiredExample: 123456789-123123123

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

execQtystringOptional

Executed quantity in the current order update.

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

cumQtystringOptional

Total Executed quantity accross all fills where the order is involved.

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

sidestring · enumRequired

Order side (B = Buy/Bid, A = Ask/Sell)

Possible values:

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

orderTypestring · enumRequired

Order type, (LIMIT = Limit, TP = Take Profit, SL = Stop Loss)

Example: TPPossible values:

triggerPxstringOptional

Price at which TP/SL orders will be triggered, should not be set for other order types.

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

timeInForcestring · enumOptional

Order time in force, exclusively used for LIMIT orders

Example: GTCPossible values:

reduceOnlybooleanOptional

Whether this is a reduce-only order, exclusively used for LIMIT IOC orders.

Example: false

statusstring · enumRequired

Order status

Possible values:

createdAtintegerRequired

Creation timestamp (milliseconds)

Example: 1747927089946

lastUpdateAtintegerRequired

Last update timestamp (milliseconds)

Example: 1747927089946

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/openOrders

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/openOrders HTTP/1.1
Host: api.reya.xyz
Accept: */*

[
  {
    "exchangeId": 1747927089946,
    "symbol": "BTCRUSDPERP",
    "accountId": 1747927089946,
    "orderId": "123456789-123123123",
    "qty": "1.0",
    "execQty": "1.0",
    "cumQty": "1.0",
    "side": "B",
    "limitPx": "43000.00",
    "orderType": "TP",
    "triggerPx": "43000.00",
    "timeInForce": "GTC",
    "reduceOnly": false,
    "status": "OPEN",
    "createdAt": 1747927089946,
    "lastUpdateAt": 1747927089946,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

Get wallet configuration

get

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

/wallet/{address}/configuration

Returns trading configuration for a wallet

Path parameters

addressstringRequiredExample: 0x6c51275fd01d5dbd2da194e92f920f8598306df2Pattern: ^0x[a-fA-F0-9]{40}$

Responses

200

Wallet configuration

application/json

feeTierIdintegerRequired

Fee tier identifier

Example: 1747927089946

ogStatusbooleanRequired

OG status

Example: true

affiliateStatusbooleanRequired

Affiliate status

Example: false

refereeStatusbooleanRequired

Referee status

Example: false

Other propertiesanyOptional

400

Bad request

application/json

500

Internal server error

application/json

get

/wallet/{address}/configuration

HTTPcURLJavaScriptPython

GET /v2/wallet/{address}/configuration HTTP/1.1
Host: api.reya.xyz
Accept: */*

{
  "feeTierId": 1747927089946,
  "ogStatus": true,
  "affiliateStatus": false,
  "refereeStatus": false,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}