Skip to main content
GET
/
holders
List top token holders
curl --request GET \
  --url https://data-api.forka.st/holders
[
  {
    "token": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
    "holders": [
      {
        "proxyWallet": "0x56687bF447db6fFa42FfE2204a05edAa20f55839",
        "bio": "Macro strategist backing major economic events.",
        "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
        "pseudonym": "macro.whale",
        "amount": 12500,
        "displayUsernamePublic": true,
        "outcomeIndex": 0,
        "name": "Macro Whale",
        "profileImage": "https://cdn.forka.st/users/macro-whale.png",
        "profileImageOptimized": "https://cdn.forka.st/users/[email protected]"
      },
      {
        "proxyWallet": "0x94d37B9c164888FbA4d4b3D4639a65f8AC54a1B6",
        "bio": "On-chain analyst seeding liquidity.",
        "asset": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917:0",
        "pseudonym": "liquidity.lab",
        "amount": 8200.75,
        "displayUsernamePublic": false,
        "outcomeIndex": 0,
        "name": "Liquidity Lab",
        "profileImage": "https://cdn.forka.st/users/liquidity-lab.png",
        "profileImageOptimized": "https://cdn.forka.st/users/[email protected]"
      }
    ]
  }
]
🟡 Holder rankings refresh every sync cycle. Expect a short delay between on-chain transfers and the leaderboard reflecting them.
https://data-api.forka.st/holders ranks wallets by token balance for the specified markets. Each entry bundles the token identifier plus an array of user records (proxy wallet, pseudonym, avatar, bio, balance, and outcome index).

​
Query parameters

  • market (required): CSV list of condition IDs. The API fetches top holders for each entry.
  • limit: Number of holders per market (max 500).
  • minBalance: Drop wallets below the provided token amount.
Because the output is grouped, you can feed it directly into “top holders” sections without additional reshaping.

Query Parameters

​
market
string[]
required

Comma-separated list of condition IDs.

0x-prefixed 64-character hex string.

​
limit
integer
default:100

Number of holders to return per market (max 500).

Required range: 0 <= x <= 500
​
minBalance
number
default:1

Drop wallets below this token balance.

Required range: x >= 0

Response

Holder leaderboard returned.

​
token
string
​
holders
object[]