Skip to main content
POST
/
v1
/
solana
/
dex
/
profiles
/
wallets
/
search-profiles
Search Profiles
curl --request POST \
  --url https://refract.prismapi.io/v1/solana/dex/profiles/wallets/search-profiles \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "query": {
    "text": "cupsey",
    "fields": [
      "metadata.name"
    ]
  },
  "filter": {
    "metrics.7d.cumulative_pnl": {
      "$gt": 65000,
      "$lt": 100000
    }
  },
  "options": {
    "include_metadata": true,
    "include_labels": true,
    "include_metrics": [
      "7d"
    ]
  },
  "sort": {
    "field": "metrics.7d.cumulative_pnl",
    "direction": "desc"
  },
  "dynamic_labels": {
    "smart": {
      "metrics.30d.winrate": {
        "$gt": 70
      }
    }
  },
  "limit": 10
}
'
{
  "count": 123,
  "cursor": "<string>",
  "data": [
    {
      "updated_at": "2023-11-07T05:31:56Z",
      "synced_at": "2023-11-07T05:31:56Z",
      "wallet_address": "<string>",
      "labels": [
        "kol"
      ],
      "matched_labels": {
        "smart": [
          "<string>"
        ]
      },
      "dynamic_labels": [
        "<string>"
      ],
      "metadata": {
        "last_trade_at": "2023-11-07T05:31:56Z",
        "name": "<string>",
        "twitter_username": "<string>",
        "telegram_username": "<string>"
      },
      "metrics": {
        "30d": {
          "risk_score": 123,
          "consistency_score": 123,
          "largest_win": 123,
          "largest_loss": 123,
          "max_consecutive_wins": 123,
          "max_consecutive_losses": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_daily_pnl": 123,
          "avg_daily_roi": 123,
          "avg_daily_trade_count": 123,
          "avg_daily_traded_tokens": 123,
          "avg_daily_volume": 123,
          "avg_holding_duration": 123,
          "avg_trade_delta": 123,
          "avg_pnl": 123,
          "avg_roi": 123,
          "avg_token_pnl": 123,
          "avg_token_roi": 123,
          "token_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "trade_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "position_count": 123,
          "win_count": 123,
          "loss_count": 123,
          "pnl": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "volume": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "winrate": 123,
          "volume_weighted_winrate": 123,
          "roi": 123,
          "volume_weighted_roi": 123,
          "time_weighted_roi": 123,
          "pnl_volume_ratio": 123,
          "token_hit_ratio": 123,
          "win_loss_size_ratio": 123,
          "profit_factor": 123,
          "profit_expectancy": 123,
          "recovery_factor": 123,
          "winrate_stability": 123,
          "winrate_volatility": 123,
          "pnl_stability": 123,
          "pnl_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123,
          "risk_of_ruin": 123,
          "turnover": 123
        },
        "14d": {
          "risk_score": 123,
          "consistency_score": 123,
          "largest_win": 123,
          "largest_loss": 123,
          "max_consecutive_wins": 123,
          "max_consecutive_losses": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_daily_pnl": 123,
          "avg_daily_roi": 123,
          "avg_daily_trade_count": 123,
          "avg_daily_traded_tokens": 123,
          "avg_daily_volume": 123,
          "avg_holding_duration": 123,
          "avg_trade_delta": 123,
          "avg_pnl": 123,
          "avg_roi": 123,
          "avg_token_pnl": 123,
          "avg_token_roi": 123,
          "token_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "trade_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "position_count": 123,
          "win_count": 123,
          "loss_count": 123,
          "pnl": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "volume": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "winrate": 123,
          "volume_weighted_winrate": 123,
          "roi": 123,
          "volume_weighted_roi": 123,
          "time_weighted_roi": 123,
          "pnl_volume_ratio": 123,
          "token_hit_ratio": 123,
          "win_loss_size_ratio": 123,
          "profit_factor": 123,
          "profit_expectancy": 123,
          "recovery_factor": 123,
          "winrate_stability": 123,
          "winrate_volatility": 123,
          "pnl_stability": 123,
          "pnl_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123,
          "risk_of_ruin": 123,
          "turnover": 123
        },
        "7d": {
          "risk_score": 123,
          "consistency_score": 123,
          "largest_win": 123,
          "largest_loss": 123,
          "max_consecutive_wins": 123,
          "max_consecutive_losses": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_daily_pnl": 123,
          "avg_daily_roi": 123,
          "avg_daily_trade_count": 123,
          "avg_daily_traded_tokens": 123,
          "avg_daily_volume": 123,
          "avg_holding_duration": 123,
          "avg_trade_delta": 123,
          "avg_pnl": 123,
          "avg_roi": 123,
          "avg_token_pnl": 123,
          "avg_token_roi": 123,
          "token_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "trade_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "position_count": 123,
          "win_count": 123,
          "loss_count": 123,
          "pnl": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "volume": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "winrate": 123,
          "volume_weighted_winrate": 123,
          "roi": 123,
          "volume_weighted_roi": 123,
          "time_weighted_roi": 123,
          "pnl_volume_ratio": 123,
          "token_hit_ratio": 123,
          "win_loss_size_ratio": 123,
          "profit_factor": 123,
          "profit_expectancy": 123,
          "recovery_factor": 123,
          "winrate_stability": 123,
          "winrate_volatility": 123,
          "pnl_stability": 123,
          "pnl_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123,
          "risk_of_ruin": 123,
          "turnover": 123
        },
        "3d": {
          "risk_score": 123,
          "consistency_score": 123,
          "largest_win": 123,
          "largest_loss": 123,
          "max_consecutive_wins": 123,
          "max_consecutive_losses": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_daily_pnl": 123,
          "avg_daily_roi": 123,
          "avg_daily_trade_count": 123,
          "avg_daily_traded_tokens": 123,
          "avg_daily_volume": 123,
          "avg_holding_duration": 123,
          "avg_trade_delta": 123,
          "avg_pnl": 123,
          "avg_roi": 123,
          "avg_token_pnl": 123,
          "avg_token_roi": 123,
          "token_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "trade_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "position_count": 123,
          "win_count": 123,
          "loss_count": 123,
          "pnl": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "volume": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "winrate": 123,
          "volume_weighted_winrate": 123,
          "roi": 123,
          "volume_weighted_roi": 123,
          "time_weighted_roi": 123,
          "pnl_volume_ratio": 123,
          "token_hit_ratio": 123,
          "win_loss_size_ratio": 123,
          "profit_factor": 123,
          "profit_expectancy": 123,
          "recovery_factor": 123,
          "winrate_stability": 123,
          "winrate_volatility": 123,
          "pnl_stability": 123,
          "pnl_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123,
          "risk_of_ruin": 123,
          "turnover": 123
        },
        "1d": {
          "risk_score": 123,
          "consistency_score": 123,
          "largest_win": 123,
          "largest_loss": 123,
          "max_consecutive_wins": 123,
          "max_consecutive_losses": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_daily_pnl": 123,
          "avg_daily_roi": 123,
          "avg_daily_trade_count": 123,
          "avg_daily_traded_tokens": 123,
          "avg_daily_volume": 123,
          "avg_holding_duration": 123,
          "avg_trade_delta": 123,
          "avg_pnl": 123,
          "avg_roi": 123,
          "avg_token_pnl": 123,
          "avg_token_roi": 123,
          "token_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "trade_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "position_count": 123,
          "win_count": 123,
          "loss_count": 123,
          "pnl": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "volume": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "winrate": 123,
          "volume_weighted_winrate": 123,
          "roi": 123,
          "volume_weighted_roi": 123,
          "time_weighted_roi": 123,
          "pnl_volume_ratio": 123,
          "token_hit_ratio": 123,
          "win_loss_size_ratio": 123,
          "profit_factor": 123,
          "profit_expectancy": 123,
          "recovery_factor": 123,
          "winrate_stability": 123,
          "winrate_volatility": 123,
          "pnl_stability": 123,
          "pnl_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123,
          "risk_of_ruin": 123,
          "turnover": 123
        }
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.prismapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Your Prism API key. You can get one for free in the Prism Dashboard.

Body

application/json
​
query
object

Full-text query used to match profiles by a text value against one or more fields.

​
filter
object

Conditions that a profile must satisfy to be included in the results. Each key is either a field path paired with comparison operators, or a logical operator ($and, $or) that combines nested filter objects.

Example:
{
  "$or": [
    {
      "metrics.7d.cumulative_pnl": { "$gt": 65000, "$lt": 100000 }
    },
    { "metrics.30d.max_drawdown": { "$lt": 20 } }
  ]
}
​
sort
object

Rule that determines the order in which matching profiles are returned.

​
dynamic_labels
object

Map of custom label names to filter rules. Each returned profile is tagged with a label when its data satisfies the corresponding filter, allowing you to annotate results with ad-hoc categories defined at query time.

Example:
{
  "smart": { "metrics.30d.winrate": { "$gt": 70 } }
}
​
options
object

Controls which optional sections are included in each returned wallet profile.

​
limit
integer
default:20

Maximum number of results to return in a single page.

Required range: 1 <= x <= 100
​
cursor
string

Opaque cursor returned by a previous response. Pass it to fetch the next page of results.

Response

List of wallet profiles found from the search.

​
count
integer

Total number of matching items

​
cursor
string

Cursor for pagination

​
data
object[]