---
title: "GET /v2/social/leaderboards/{cohort}"
method: GET
path: "/v2/social/leaderboards/{cohort}"
tags: ["Social Activity"]
---

# GET /v2/social/leaderboards/{cohort}

`GET /v2/social/leaderboards/{cohort}`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/social/leaderboards/{cohort}`
- Auth: HTTP bearer

Lists one provider leaderboard cohort, rank 1 first, from the immutable snapshot that is currently active. A cursor pins the snapshot it was issued from so paging stays stable when a newer snapshot activates; isCurrent reports whether that snapshot is still the active one. Metrics are exact provider-observed strings; null means the provider did not report the value. traderProfileId is set only when the account resolves through /v2/social/traders/{trader_profile_id}. Returns 404 while no snapshot has been observed. Rankings of posts and tokens remain deferred; this read exposes stored provider results only.

## Path parameters

- `cohort` 'fomo_top_100_7d' | 'pump_top_100_weekly', required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

One page of the cohort snapshot in rank order

- SocialLeaderboardPage: A rank-ordered page of one immutable provider leaderboard snapshot. Provider observations only; not wallet ownership or financial authority.
  - `capturedAtMs` string, required: When the provider captured the leaderboard.
  - `cohort` 'fomo_top_100_7d' | 'pump_top_100_weekly', required
  - `entryCount` 100, required: Entries in the whole snapshot, independent of pagination.
  - `isCurrent` boolean, required: Whether this snapshot is still the active one for the cohort.
  - `items` SocialLeaderboardEntry[], required
    - `avatarUrl` string, nullable, required
    - `displayName` string, nullable, required
    - `followerCount` string, nullable, required: Provider-reported follower count at capture time; null when unreported.
    - `handle` string, nullable, required
    - `periodPnlUsd` string, nullable, required: Dollar profit or loss over the ranking period as reported by the provider (realized plus unrealized where the provider splits them); null when unreported.
    - `periodRealizedPnlUsd` string, nullable, required: Realized dollar profit or loss over the ranking period; null when unreported.
    - `periodReturnPct` string, nullable, required: Percentage return over the ranking period (seven_day for Fomo, weekly for pump.fun) as reported by the provider; null when unreported, never zero.
    - `periodTradeCount` string, nullable, required: Number of trades over the ranking period; null when unreported.
    - `periodUnrealizedPnlUsd` string, nullable, required: Unrealized dollar profit or loss over the ranking period; null when unreported.
    - `periodVolumeUsd` string, nullable, required: Traded dollar volume over the ranking period; null when unreported.
    - `platform` 'fomo' | 'pump', required
    - `platformSubjectId` string, required
    - `profileObservedAtMs` string, nullable, required
    - `rank` integer, required
    - `traderProfileId` string, uuid, nullable, required: Resolvable through /v2/social/traders/{trader_profile_id}; null when the account is private or lacks a verified wallet.
    - `walletAddress` string, nullable, required: Provider-observed Solana wallet for the ranked account, when reported.
  - `nextCursor` string, nullable, required
  - `observedAtMs` string, required: When Arbital observed the snapshot.
  - `period` 'seven_day' | 'weekly', required: The ranking period every period* metric covers: seven_day (Fomo top 100, trailing seven days) or weekly (pump.fun weekly board).
  - `platform` 'fomo' | 'pump', required
  - `snapshotId` string, uuid, required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `404`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `429`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

[API](https://skmtc.dev/arbital/apis/arbital-api.md) - [All operations](https://skmtc.dev/arbital/apis/arbital-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arbital/apis/arbital-api/revisions/bb0185edf43a?raw)