---
title: "Unified search across users, tokens, and clans"
method: GET
path: "/v1/search"
tags: ["search"]
---

# Unified search across users, tokens, and clans

`GET /v1/search`

## Query parameters

- `limit` integer
- `cursor` string
- `query` string, required

## Response `200`

Successful response

- object
  - `users` object, required
    - `items` SearchUserResult[], required
      - `user` PublicUser, required
        - `id` string, required
        - `telegram_id` string, nullable, required
        - `username` string, required
        - `display_name` string, required
        - `referral_code` string, nullable, required
        - `referral_code_alt` string, nullable, required
        - `referred_by_id` string, nullable, required
        - `wallet_address` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `x_username` string, nullable, required
        - `last_online` string, nullable, required
        - `last_online_mobile` string, nullable, required
        - `avatar_url` string, required
        - `bio` string, nullable, required
        - `clan_id` string, nullable, required
        - `clan` UserClan, nullable
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `image_url` string, nullable, required
          - `banner_url` string, nullable, required
          - `chat_room_id` string, nullable, required
          - `created_at` string, required
          - `updated_at` string, required
        - `rank` integer, nullable, required
        - `rank_testnet` integer, nullable, required
        - `streak` integer, nullable, required
        - `elo` integer, nullable, required
        - `is_npc` boolean, required
        - `last_reset_at` string, nullable, required
        - `feature_image` string, required
        - `completed_onboarding` boolean, required
        - `dismissed_trade_note_cta` boolean, required
        - `has_deposited` boolean, required
        - `invite_code_id` string, nullable, required
        - `main_signer_quorum_id` string, nullable, required
        - `builder_fee_override` integer, nullable, required
        - `fee_rebate_rate` number, nullable, required
        - `deleted_at` string, nullable, required
        - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `restrict_dms_to_following` boolean, required
        - `pnl_share_enabled` boolean, required
        - `pnl_share_rate` number, required
        - `acknowledged_season_zero` boolean, required
        - `notification_preferences` unknown, required
        - `fat_finger_settings` unknown, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
        - `trader_level_seen` integer, nullable, required
        - `max_market_order_slippage` number, nullable, required
        - `wallets` Wallet[]
          - `id` string, required
          - `user_id` string, required
          - `address` string, required
          - `type` 'primary' | 'arena' | 'copy_trading', required
          - `privy_wallet_id` string, required
          - `signer_quorum_id` string, nullable, required
          - `hl_setup_complete` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
      - `followers_count` integer, required
      - `top_positions` object[], required
        - `id` string, required
        - `network` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `user_id` string, required
        - `wallet_address` string, required
        - `symbol` string, required
        - `side` 'LONG' | 'SHORT', required
        - `size` number, required
        - `entry_price` number, required
        - `max_size` number, nullable, required
        - `leverage_type` string, required
        - `leverage_value` integer, required
        - `margin_used` number, nullable, required
        - `realized_pnl` number, required
        - `unrealized_pnl` number, required
        - `cum_funding_since_open` number, required
        - `cum_funding_since_change` number, required
        - `opened_at` string, required
        - `updated_at` string, required
        - `closed_at` string, nullable, required
        - `closed_price` number, nullable, required
        - `close_reason` 'MANUAL' | 'TAKE_PROFIT' | 'STOP_LOSS' | 'TRAILING_STOP' | 'LIQUIDATION' | 'AUTO_DELEVERAGE', nullable, required
        - `close_notified_at` string, nullable, required
        - `open_notified_at` string, nullable, required
        - `position_move_last_notified_pct` number, nullable, required
        - `notional_usd` number, nullable, required
      - `pnl_usd` number, nullable, required
      - `unrealized_pnl_usd` number, nullable, required
      - `total_pnl_usd` number, nullable, required
      - `roi_percent` number, nullable, required
    - `hasMore` boolean, required
  - `clans` object, required
    - `items` Clan[], required
      - `id` string, required
      - `name` string, required
      - `description` string, nullable, required
      - `members` ClanMember[]
        - `user` PublicUser, required
          - `id` string, required
          - `telegram_id` string, nullable, required
          - `username` string, required
          - `display_name` string, required
          - `referral_code` string, nullable, required
          - `referral_code_alt` string, nullable, required
          - `referred_by_id` string, nullable, required
          - `wallet_address` string, nullable, required
          - `created_at` string, required
          - `updated_at` string, required
          - `x_username` string, nullable, required
          - `last_online` string, nullable, required
          - `last_online_mobile` string, nullable, required
          - `avatar_url` string, required
          - `bio` string, nullable, required
          - `clan_id` string, nullable, required
          - `clan` UserClan, nullable
            - `id` string, required
            - `name` string, required
            - `description` string, nullable, required
            - `image_url` string, nullable, required
            - `banner_url` string, nullable, required
            - `chat_room_id` string, nullable, required
            - `created_at` string, required
            - `updated_at` string, required
          - `rank` integer, nullable, required
          - `rank_testnet` integer, nullable, required
          - `streak` integer, nullable, required
          - `elo` integer, nullable, required
          - `is_npc` boolean, required
          - `last_reset_at` string, nullable, required
          - `feature_image` string, required
          - `completed_onboarding` boolean, required
          - `dismissed_trade_note_cta` boolean, required
          - `has_deposited` boolean, required
          - `invite_code_id` string, nullable, required
          - `main_signer_quorum_id` string, nullable, required
          - `builder_fee_override` integer, nullable, required
          - `fee_rebate_rate` number, nullable, required
          - `deleted_at` string, nullable, required
          - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
          - `restrict_dms_to_following` boolean, required
          - `pnl_share_enabled` boolean, required
          - `pnl_share_rate` number, required
          - `acknowledged_season_zero` boolean, required
          - `notification_preferences` unknown, required
          - `fat_finger_settings` unknown, required
          - `account_value_tier` integer, required
          - `is_official` boolean, required
          - `trader_level_seen` integer, nullable, required
          - `max_market_order_slippage` number, nullable, required
          - `wallets` Wallet[]
            - `id` string, required
            - `user_id` string, required
            - `address` string, required
            - `type` 'primary' | 'arena' | 'copy_trading', required
            - `privy_wallet_id` string, required
            - `signer_quorum_id` string, nullable, required
            - `hl_setup_complete` boolean, required
            - `created_at` string, required
            - `updated_at` string, required
        - `role` 'owner' | 'admin' | 'member', required
        - `joinedAt` string, required
        - `accountValue` number, required
        - `pnlUsd` number, required
        - `roiPercent` number, nullable, required
        - `volumeUsd` number, required
      - `imageUrl` string, nullable, required
      - `bannerUrl` string, nullable, required
      - `chatRoomId` string, nullable, required
      - `channelName` string, nullable, required
      - `createdAt` string, required
      - `owner` PublicUser, required
        - `id` string, required
        - `telegram_id` string, nullable, required
        - `username` string, required
        - `display_name` string, required
        - `referral_code` string, nullable, required
        - `referral_code_alt` string, nullable, required
        - `referred_by_id` string, nullable, required
        - `wallet_address` string, nullable, required
        - `created_at` string, required
        - `updated_at` string, required
        - `x_username` string, nullable, required
        - `last_online` string, nullable, required
        - `last_online_mobile` string, nullable, required
        - `avatar_url` string, required
        - `bio` string, nullable, required
        - `clan_id` string, nullable, required
        - `clan` UserClan, nullable
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `image_url` string, nullable, required
          - `banner_url` string, nullable, required
          - `chat_room_id` string, nullable, required
          - `created_at` string, required
          - `updated_at` string, required
        - `rank` integer, nullable, required
        - `rank_testnet` integer, nullable, required
        - `streak` integer, nullable, required
        - `elo` integer, nullable, required
        - `is_npc` boolean, required
        - `last_reset_at` string, nullable, required
        - `feature_image` string, required
        - `completed_onboarding` boolean, required
        - `dismissed_trade_note_cta` boolean, required
        - `has_deposited` boolean, required
        - `invite_code_id` string, nullable, required
        - `main_signer_quorum_id` string, nullable, required
        - `builder_fee_override` integer, nullable, required
        - `fee_rebate_rate` number, nullable, required
        - `deleted_at` string, nullable, required
        - `network_mode` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper', required
        - `restrict_dms_to_following` boolean, required
        - `pnl_share_enabled` boolean, required
        - `pnl_share_rate` number, required
        - `acknowledged_season_zero` boolean, required
        - `notification_preferences` unknown, required
        - `fat_finger_settings` unknown, required
        - `account_value_tier` integer, required
        - `is_official` boolean, required
        - `trader_level_seen` integer, nullable, required
        - `max_market_order_slippage` number, nullable, required
        - `wallets` Wallet[]
          - `id` string, required
          - `user_id` string, required
          - `address` string, required
          - `type` 'primary' | 'arena' | 'copy_trading', required
          - `privy_wallet_id` string, required
          - `signer_quorum_id` string, nullable, required
          - `hl_setup_complete` boolean, required
          - `created_at` string, required
          - `updated_at` string, required
      - `memberCount` integer, required
      - `myRole` 'owner' | 'admin' | 'member'
    - `hasMore` boolean, required
  - `query` string, required

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/legend/apis/legend-api.md) · [All operations](https://skmtc.net/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/legend/legend-api/versions/d9a714c3ff23/schema)