List traders

curl --request GET \
  --url https://api.reperp.xyz/api/v1/wallet/discover \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.reperp.xyz/api/v1/wallet/discover', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "data": {
    "data": [
      {
        "address": "<string>",
        "lastActivity": "2023-11-07T05:31:56Z",
        "metrics": {
          "all": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          },
          "30d": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          },
          "7d": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          }
        },
        "copyScore": {
          "score": 123,
          "tier": "S",
          "eligibilityReason": "insufficient_history",
          "perf": 123,
          "copyability": 123,
          "sharpe": 123,
          "drawdown": 123,
          "consistency": 123,
          "frequency": 123,
          "sizing": 123,
          "confidence": 123,
          "directionBias": 123,
          "directionBiasLabel": "Long-only",
          "directionEdge": "Bull specialist"
        },
        "chartData": [
          {
            "date": "2023-12-25",
            "pnl": 123,
            "cumulativePnl": 123
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": 123,
      "totalPages": 123,
      "totalCount": 123,
      "pageSize": 123
    },
    "asOf": "<string>"
  }
}

{
  "status": "error",
  "message": "<string>",
  "errors": [
    {}
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Too many requests. Please wait for a moment."
}

GET

wallet

discover

List traders

curl --request GET \
  --url https://api.reperp.xyz/api/v1/wallet/discover \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.reperp.xyz/api/v1/wallet/discover', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "data": {
    "data": [
      {
        "address": "<string>",
        "lastActivity": "2023-11-07T05:31:56Z",
        "metrics": {
          "all": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          },
          "30d": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          },
          "7d": {
            "pnl": 123,
            "totalPnlAfterFee": 123,
            "totalProfit": 123,
            "totalLoss": 123,
            "winRate": 123,
            "totalTrades": 123,
            "avgTradeSize": 123,
            "volume": 123,
            "drawdown": 123,
            "pnlRatio": 123
          }
        },
        "copyScore": {
          "score": 123,
          "tier": "S",
          "eligibilityReason": "insufficient_history",
          "perf": 123,
          "copyability": 123,
          "sharpe": 123,
          "drawdown": 123,
          "consistency": 123,
          "frequency": 123,
          "sizing": 123,
          "confidence": 123,
          "directionBias": 123,
          "directionBiasLabel": "Long-only",
          "directionEdge": "Bull specialist"
        },
        "chartData": [
          {
            "date": "2023-12-25",
            "pnl": 123,
            "cumulativePnl": 123
          }
        ]
      }
    ],
    "pagination": {
      "currentPage": 123,
      "totalPages": 123,
      "totalCount": 123,
      "pageSize": 123
    },
    "asOf": "<string>"
  }
}

{
  "status": "error",
  "message": "<string>",
  "errors": [
    {}
  ]
}

{
  "error": "Unauthorized"
}

{
  "error": "Too many requests. Please wait for a moment."
}

Authorizations

x-api-key

string

header

required

Your API key. Keys are issued on request: message @perp_ag on X.

Query Parameters

platform

enum<string>

required

Venue. See Venues and identifiers.

Available options:

LIGHTER,

RHLT,

JUPITER,

PHOENIX,

BULLET,

AFTERMATH

sort_by

enum<string>

default:copy_score

Sort column.

Available options:

total_pnl_after_fee,

total_trades,

total_avg_trade_size,

total_volume,

total_win_rate,

total_pnl_delta,

total_profit,

total_drawdown,

total_pnl_ratio,

30d_pnl_after_fee,

30d_trades,

30d_avg_trade_size,

30d_volume,

30d_win_rate,

30d_pnl_delta,

30d_profit,

30d_drawdown,

30d_pnl_ratio,

7d_pnl_after_fee,

7d_trades,

7d_avg_trade_size,

7d_volume,

7d_win_rate,

7d_pnl_delta,

7d_profit,

7d_drawdown,

7d_pnl_ratio,

copy_score,

perf_score,

copyability,

sharpe_score,

drawdown_score,

consistency_score,

confidence

sort_order

enum<string>

default:desc

Sort direction.

Available options:

asc,

desc

page

integer

default:1

Page, from 1.

Required range: x >= 1

limit

integer

default:100

Rows per page.

Required range: 1 <= x <= 100

chart_range

enum<string>

Window of the PnL chart in each row.

Available options:

7d,

30d,

all

copy_score_tier

enum<string>[]

Keep wallets in these Copy Score tiers. Repeat the parameter for several tiers.

Available options:

S,

A,

B,

C,

D

gte_copy_score

number

Minimum Copy Score.

Required range: 0 <= x <= 100

lte_copy_score

number

Maximum Copy Score.

Required range: 0 <= x <= 100

direction_bias_label

enum<string>

Keep wallets with this directional lean.

Available options:

Long-only,

Long-biased,

Balanced,

Short-biased,

Short-only

direction_edge

enum<string>

Keep wallets with this edge.

Available options:

Bull specialist,

Bear specialist,

Two-sided

last_activity

enum<string>

default:all

Keep wallets that traded within this window.

Available options:

all,

24h,

7d,

30d,

3m

gte_total_pnl_after_fee

number

Keep wallets whose total pnl after fee is at least this value.

lte_total_pnl_after_fee

number

Keep wallets whose total pnl after fee is at most this value.

gte_total_trades

number

Keep wallets whose total trades is at least this value.

lte_total_trades

number

Keep wallets whose total trades is at most this value.

gte_total_avg_trade_size

number

Keep wallets whose total avg trade size is at least this value.

lte_total_avg_trade_size

number

Keep wallets whose total avg trade size is at most this value.

gte_total_volume

number

Keep wallets whose total volume is at least this value.

lte_total_volume

number

Keep wallets whose total volume is at most this value.

gte_total_win_rate

number

Keep wallets whose total win rate is at least this value.

lte_total_win_rate

number

Keep wallets whose total win rate is at most this value.

gte_total_pnl_delta

number

Keep wallets whose total pnl delta is at least this value.

lte_total_pnl_delta

number

Keep wallets whose total pnl delta is at most this value.

gte_total_profit

number

Keep wallets whose total profit is at least this value.

lte_total_profit

number

Keep wallets whose total profit is at most this value.

gte_total_drawdown

number

Keep wallets whose total drawdown is at least this value.

lte_total_drawdown

number

Keep wallets whose total drawdown is at most this value.

gte_total_pnl_ratio

number

Keep wallets whose total pnl ratio is at least this value.

lte_total_pnl_ratio

number

Keep wallets whose total pnl ratio is at most this value.

gte_30d_pnl_after_fee

number

Keep wallets whose 30d pnl after fee is at least this value.

lte_30d_pnl_after_fee

number

Keep wallets whose 30d pnl after fee is at most this value.

gte_30d_trades

number

Keep wallets whose 30d trades is at least this value.

lte_30d_trades

number

Keep wallets whose 30d trades is at most this value.

gte_30d_avg_trade_size

number

Keep wallets whose 30d avg trade size is at least this value.

lte_30d_avg_trade_size

number

Keep wallets whose 30d avg trade size is at most this value.

gte_30d_volume

number

Keep wallets whose 30d volume is at least this value.

lte_30d_volume

number

Keep wallets whose 30d volume is at most this value.

gte_30d_win_rate

number

Keep wallets whose 30d win rate is at least this value.

lte_30d_win_rate

number

Keep wallets whose 30d win rate is at most this value.

gte_30d_pnl_delta

number

Keep wallets whose 30d pnl delta is at least this value.

lte_30d_pnl_delta

number

Keep wallets whose 30d pnl delta is at most this value.

gte_30d_profit

number

Keep wallets whose 30d profit is at least this value.

lte_30d_profit

number

Keep wallets whose 30d profit is at most this value.

gte_30d_drawdown

number

Keep wallets whose 30d drawdown is at least this value.

lte_30d_drawdown

number

Keep wallets whose 30d drawdown is at most this value.

gte_30d_pnl_ratio

number

Keep wallets whose 30d pnl ratio is at least this value.

lte_30d_pnl_ratio

number

Keep wallets whose 30d pnl ratio is at most this value.

gte_7d_pnl_after_fee

number

Keep wallets whose 7d pnl after fee is at least this value.

lte_7d_pnl_after_fee

number

Keep wallets whose 7d pnl after fee is at most this value.

gte_7d_trades

number

Keep wallets whose 7d trades is at least this value.

lte_7d_trades

number

Keep wallets whose 7d trades is at most this value.

gte_7d_avg_trade_size

number

Keep wallets whose 7d avg trade size is at least this value.

lte_7d_avg_trade_size

number

Keep wallets whose 7d avg trade size is at most this value.

gte_7d_volume

number

Keep wallets whose 7d volume is at least this value.

lte_7d_volume

number

Keep wallets whose 7d volume is at most this value.

gte_7d_win_rate

number

Keep wallets whose 7d win rate is at least this value.

lte_7d_win_rate

number

Keep wallets whose 7d win rate is at most this value.

gte_7d_pnl_delta

number

Keep wallets whose 7d pnl delta is at least this value.

lte_7d_pnl_delta

number

Keep wallets whose 7d pnl delta is at most this value.

gte_7d_profit

number

Keep wallets whose 7d profit is at least this value.

lte_7d_profit

number

Keep wallets whose 7d profit is at most this value.

gte_7d_drawdown

number

Keep wallets whose 7d drawdown is at least this value.

lte_7d_drawdown

number

Keep wallets whose 7d drawdown is at most this value.

gte_7d_pnl_ratio

number

Keep wallets whose 7d pnl ratio is at least this value.

lte_7d_pnl_ratio

number

Keep wallets whose 7d pnl ratio is at most this value.

Response

Success

status

enum<string>

required

Available options:

success

data

object

required

Note the nested data: the rows are in data.data.

Show child attributes

Introduction

Traders

Wallet analytics

Positions and trades

Market

List traders

Authorizations

Query Parameters

Response