KAkairos
Trader Analytics

Search for a trader's public profile by wallet address

Fetches public profile information (display name, pseudonym, bio, avatar, X/Twitter handle, verification badge, associated user IDs) for a wallet address from the upstream provider. Provider is auto-detected from address format when omitted — Ethereum (0x...) addresses default to Polymarket and Solana addresses default to Kalshi; auto-detection maps every 0x address to Polymarket, so other EVM venues (Opinion, predictfun, ...) must pass provider explicitly. provider, when given, is validated against the central provider registry shared with /trader-stats; any registered provider is accepted, and non-Polymarket venues currently receive a synthetic (service-generated) profile rather than a live upstream fetch. This is a live provider read, not served from cached data. Auth: accepts an admin secret (X-Admin-Secret), an API key (X-Client-Id + X-Api-Key + X-Api-Secret), or a first-party JWT (Authorization header or turnkey_session_jwt cookie). No API-key scope is required — any valid credential can read a public profile. Rate-limited by the heavy group at 10 requests/minute, matching /trader-stats, because every call is a live upstream provider read.

get/search-traders

Request

  • Base URL
    https://data.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Query parameters

addressstring required

Wallet address to search for (any non-empty string; trimmed).

providerstring

Provider override. Auto-detected from address format (0x -> polymarket, Solana -> kalshi) if omitted.

Response

Trader search result. profile is null if no profile was found; error carries a provider-supplied message in that case.

providerstring required
addressstring required
errorstring nullable required

Provider-supplied error message when no profile was found.

Example response

{
  "provider": "polymarket",
  "address": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
  "profile": {
    "proxyWallet": "0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b",
    "name": "Jane Trader",
    "pseudonym": "QuietFalcon-2201",
    "bio": "Macro and elections.",
    "profileImage": "https://cdn.polymarket.com/avatars/jane.png",
    "xUsername": "janetrades",
    "createdAt": "2023-11-02T18:20:44Z",
    "users": [
      {
        "id": "usr_polymarket_884211"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.