OpenAPI Reference

OpenAPI v1 — Public market data, account positions, trade history, token metadata, protocol statistics, liquidation records, and current funding rates. All financial fields are returned as decimal string values. Price and position-related fields use 6-decimal precision.

Get all available trading markets

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/markets

Returns a list of all available trading markets with real-time prices, 24h trading volume, current open interest, and position fee rates. WBTC and WETH names are displayed as BTC and ETH.

Query parameters

statusinteger · enumOptional

Filter by market status. 1=Delisted (no longer tradable), 2=Listed (actively trading), 3=Pending delist (will be removed soon)

Possible values:

is_memebooleanOptional

Set to true to return only meme coins

is_tradfibooleanOptional

Set to true to return only TradFi assets (stocks and metals)

Responses

200

List of trading markets

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

get

/v1/markets

HTTPcURLJavaScriptPython

GET /openapi/v1/markets HTTP/1.1
Host: api.deriw.com
Accept: */*

200

List of trading markets

{
  "code": 1,
  "msg": "text",
  "data": {
    "markets": [
      {
        "address": "text",
        "name": "text",
        "decimals": 1,
        "is_stable": true,
        "is_shortable": true,
        "is_wrapped": true,
        "is_meme": true,
        "is_tradfi": true,
        "coin_type": 1,
        "fee_rate": 1,
        "price": "text",
        "volume_24h": "text",
        "long_interest": "text",
        "short_interest": "text",
        "status": 1
      }
    ]
  }
}

Get account open positions

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/account/positions

Returns the current open positions for the specified wallet address. Supports pagination up to 100 records per page, with a maximum of 10,000 total accessible records. All size, collateral, and fee values use 6-decimal precision.

Query parameters

accountstringRequired

Wallet address to query positions for

index_tokenstringOptional

Filter by index token contract address

is_longbooleanOptional

Set to true for long positions, false for short positions

page_indexinteger · min: 1Optional

Page number, starting from 1

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Number of records per page (max 100)

Default: 20

Responses

200

List of open positions

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

400

Request exceeds the maximum accessible page range

get

/v1/account/positions

HTTPcURLJavaScriptPython

GET /openapi/v1/account/positions?account=text HTTP/1.1
Host: api.deriw.com
Accept: */*

{
  "code": 1,
  "msg": "text",
  "data": {
    "positions": [
      {
        "account": "text",
        "index_token": "text",
        "token_name": "text",
        "is_long": true,
        "size": "text",
        "collateral": "text",
        "leverage": "text",
        "total_fees": "text",
        "status": 1,
        "created_at": 1,
        "updated_at": 1
      }
    ],
    "total": 1
  }
}

Get account trade history

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/trades

Returns the trade history (both open and close positions) for the specified wallet address. Each record is either an 'increase' (opening) or 'decrease' (closing) trade. Supports filtering by time range and trade type. All financial fields use 6-decimal precision.

Query parameters

accountstringRequired

Wallet address to query trade history for

index_tokenstringOptional

Filter by index token contract address

trade_typestring · enumOptional

Filter by trade direction. 'increase' = opening positions, 'decrease' = closing positions. Omit to return both.

Possible values:

from_timestampintegerOptional

Start of time range filter (Unix timestamp in seconds)

to_timestampintegerOptional

End of time range filter (Unix timestamp in seconds)

page_indexinteger · min: 1Optional

Page number, starting from 1

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Number of records per page (max 100)

Default: 20

Responses

200

List of trade records

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

400

Request exceeds the maximum accessible page range

get

/v1/trades

HTTPcURLJavaScriptPython

GET /openapi/v1/trades?account=text HTTP/1.1
Host: api.deriw.com
Accept: */*

{
  "code": 1,
  "msg": "text",
  "data": {
    "total_volume": "text",
    "history_volume": "text",
    "total": 1,
    "trades": [
      {
        "account": "text",
        "trade_type": "text",
        "index_token": "text",
        "token_name": "text",
        "is_long": true,
        "size": "text",
        "collateral": "text",
        "price": "text",
        "average_price": "text",
        "pnl": "text",
        "fee": "text",
        "tx_hash": "text",
        "block_number": 1,
        "created_at": 1
      }
    ]
  }
}

Get latest token prices

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/prices

Returns the latest real-time price and 24-hour statistics (high, low, change) for all listed tokens. Prices use 6-decimal precision (multiplied by 1e6).

Query parameters

index_tokenstringOptional

Filter by index token contract address

symbolstringOptional

Filter by token display symbol (e.g., BTC, ETH, SOL)

Responses

200

List of token prices

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

get

/v1/prices

HTTPcURLJavaScriptPython

GET /openapi/v1/prices HTTP/1.1
Host: api.deriw.com
Accept: */*

200

List of token prices

{
  "code": 1,
  "msg": "text",
  "data": {
    "prices": [
      {
        "index_token": "text",
        "symbol": "text",
        "price": "text",
        "high_24h": "text",
        "low_24h": "text",
        "change_24h": "text"
      }
    ]
  }
}

Get all supported tokens

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/tokens

Returns metadata for all supported tokens including contract address, display name, decimals, trading attributes, coin type classification, and current fee rate. WBTC and WETH names are displayed as BTC and ETH.

Query parameters

statusinteger · enumOptional

Filter by token status. 1=Delisted, 2=Listed, 3=Pending delist

Possible values:

is_memebooleanOptional

Set to true to return only meme coins

is_tradfibooleanOptional

Set to true to return only TradFi assets (stocks and metals)

Responses

200

List of supported tokens

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

get

/v1/tokens

HTTPcURLJavaScriptPython

GET /openapi/v1/tokens HTTP/1.1
Host: api.deriw.com
Accept: */*

200

List of supported tokens

{
  "code": 1,
  "msg": "text",
  "data": {
    "tokens": [
      {
        "address": "text",
        "name": "text",
        "decimals": 1,
        "is_stable": true,
        "is_shortable": true,
        "is_wrapped": true,
        "is_meme": true,
        "is_tradfi": true,
        "coin_type": 1,
        "fee_rate": "text",
        "price": "text",
        "status": 1
      }
    ]
  }
}

Get protocol statistics

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/stats

Returns aggregated protocol-wide statistics including trading volume, fees, revenue, open interest, TVL, fund pool data, and unique trader count. All financial fields use 6-decimal precision. Unique traders is an integer count.

Query parameters

from_timestampintegerOptional

Start of time range filter (Unix timestamp in seconds)

to_timestampintegerOptional

End of time range filter (Unix timestamp in seconds)

Responses

200

Protocol statistics

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

get

/v1/stats

HTTPcURLJavaScriptPython

GET /openapi/v1/stats HTTP/1.1
Host: api.deriw.com
Accept: */*

200

Protocol statistics

{
  "code": 1,
  "msg": "text",
  "data": {
    "total_volume": "text",
    "trading_volume": "text",
    "long_volume": "text",
    "short_volume": "text",
    "total_fees": "text",
    "open_fee": "text",
    "close_fee": "text",
    "liquidation_fee": "text",
    "manage_fee": "text",
    "total_revenue": "text",
    "long_revenue": "text",
    "short_revenue": "text",
    "open_interest": "text",
    "long_open_interest": "text",
    "short_open_interest": "text",
    "long_weighting": "text",
    "short_weighting": "text",
    "tvl": "text",
    "fund_pool_volume": "text",
    "fund_pool_raised": "text",
    "unique_traders": 1,
    "updated_at": 1
  }
}

Get account liquidation history

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/liquidations

Returns liquidation records for the specified wallet address. Each record includes liquidation type: type 2 or 3 indicates normal liquidation events, type 4 indicates forced closure due to coin delisting, and type 5 indicates ADL (Auto-Deleveraging) events. All financial fields use 6-decimal precision.

Query parameters

accountstringRequired

Wallet address to query liquidation history for

index_tokenstringOptional

Filter by index token contract address

is_longbooleanOptional

Set to true for long positions, false for short positions

from_timestampintegerOptional

Start of time range filter (Unix timestamp in seconds)

to_timestampintegerOptional

End of time range filter (Unix timestamp in seconds)

page_indexinteger · min: 1Optional

Page number, starting from 1

Default: 1

page_sizeinteger · min: 1 · max: 100Optional

Number of records per page (max 100)

Default: 20

Responses

200

List of liquidation records

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

400

Request exceeds the maximum accessible page range

get

/v1/liquidations

HTTPcURLJavaScriptPython

GET /openapi/v1/liquidations?account=text HTTP/1.1
Host: api.deriw.com
Accept: */*

{
  "code": 1,
  "msg": "text",
  "data": {
    "liquidations": [
      {
        "account": "text",
        "index_token": "text",
        "is_long": true,
        "size": "text",
        "collateral": "text",
        "average_price": "text",
        "mark_price": "text",
        "liquidation_price": "text",
        "fee": "text",
        "realised_pnl": "text",
        "liquidation_type": 1,
        "tx_hash": "text",
        "block_number": 1,
        "created_at": 1
      }
    ],
    "total": 1
  }
}

Get current position fee rates

get

https://api.deriw.com/openapihttps://api.test.deriw.com/openapi

/v1/funding_rates

Returns the current position fee rate (in basis points) for each listed token. The fee rate represents the cost to open a position, expressed in bps where 1 bps = 0.01%. Returns all listed tokens when no filter is specified.

Query parameters

index_tokenstringOptional

Filter by index token contract address. Omit to return fee rates for all listed tokens.

Responses

200

List of current fee rates

application/json

codeintegerOptional

Response status code. 0 = success

msgstringOptional

Response message. 'success' on success

get

/v1/funding_rates

HTTPcURLJavaScriptPython

GET /openapi/v1/funding_rates HTTP/1.1
Host: api.deriw.com
Accept: */*

200

List of current fee rates

{
  "code": 1,
  "msg": "text",
  "data": {
    "funding_rates": [
      {
        "index_token": "text",
        "name": "text",
        "fee_rate": 1
      }
    ]
  }
}