Skip to main content
POST
/
v1
/
solana
/
dex
/
profiles
/
tokens
/
search-profiles
Search Profiles
curl --request POST \
  --url https://refract.prismapi.io/v1/solana/dex/profiles/tokens/search-profiles \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "query": {
    "text": "bonk",
    "fields": [
      "metadata.name"
    ]
  },
  "filter": {
    "market.liquidity": {
      "$gt": 1000000
    }
  },
  "options": {
    "include_metadata": true,
    "include_market": true,
    "include_labels": true,
    "include_metrics": [
      "7d"
    ]
  },
  "sort": {
    "field": "market.liquidity",
    "direction": "desc"
  },
  "dynamic_labels": {
    "trending": {
      "metrics.5m.volume": {
        "$gt": 1000000
      }
    }
  },
  "limit": 10
}
'
{
  "count": 123,
  "cursor": "<string>",
  "data": [
    {
      "updated_at": "2023-11-07T05:31:56Z",
      "synced_at": "2023-11-07T05:31:56Z",
      "token_address": "<string>",
      "labels": [
        "trending"
      ],
      "matched_labels": {
        "trending": [
          "<string>"
        ]
      },
      "dynamic_labels": [
        "<string>"
      ],
      "metadata": {
        "last_trade_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "symbol": "<string>",
        "name": "<string>",
        "image": "<string>",
        "verified": true,
        "creator_address": "<string>",
        "twitter": "<string>",
        "discord": "<string>",
        "website": "<string>",
        "telegram": "<string>"
      },
      "market": {
        "fdv": 123,
        "market_cap": 123,
        "price": 123,
        "liquidity": 123,
        "holders": 123,
        "total_supply": 123,
        "circulating_supply": 123,
        "top_holdings": 123,
        "dev_holdings": 123
      },
      "metrics": {
        "7d": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123
        },
        "1d": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123
        },
        "6h": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123
        },
        "1h": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123
        },
        "5m": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 123
        },
        "1m": {
          "largest_trade_win": 123,
          "largest_trade_loss": 123,
          "avg_buy_size": 123,
          "avg_sell_size": 123,
          "avg_price": 123,
          "avg_buy_price": 123,
          "avg_sell_price": 123,
          "avg_buy_mcap": 123,
          "avg_sell_mcap": 123,
          "avg_holding_duration": 123,
          "avg_trade_pnl": 123,
          "avg_trade_roi": 123,
          "avg_wallet_winrate": 123,
          "avg_wallet_pnl": 123,
          "avg_wallet_roi": 123,
          "wallet_roi_distribution": {
            "gt_500": 123,
            "200_500": 123,
            "0_200": 123,
            "neg50_0": 123,
            "lt_neg50_0": 123
          },
          "makers_count": 123,
          "buyers_count": 123,
          "sellers_count": 123,
          "buy_count": 123,
          "sell_count": 123,
          "win_position_count": 123,
          "loss_position_count": 123,
          "win_pnl": 123,
          "loss_pnl": 123,
          "buy_volume": 123,
          "sell_volume": 123,
          "pnl": 123,
          "trade_count": 123,
          "volume": 123,
          "position_count": 123,
          "volume_weighted_winrate": 123,
          "volume_weighted_roi": 123,
          "wallet_hit_ratio": 123,
          "profit_factor": 123,
          "win_loss_size_ratio": 123,
          "pnl_volume_ratio": 123,
          "price_stability": 123,
          "price_volatility": 123,
          "roi_stability": 123,
          "roi_volatility": 123,
          "pnl_volatility": 123,
          "pnl_stability": 123,
          "sharpe_ratio": 123,
          "sortino_ratio": 123,
          "max_drawdown": 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 token 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 filtered and sorted token profiles.

​
count
integer

Total number of matching items

​
cursor
string

Cursor for pagination

​
data
object[]