Fetch power user objects

farcasterUser.getPowerUsers

Overview

Fetches power users based on Warpcast power badges. Information is updated once a day.

Parameters

name	type	required	Note
viewer_fid	number	false	ex) 3
limit	number	false	default: 25, max: 100
cursor	string	false	ex) eyJwYWdlIjoyfQ==

Usage

Typescript

let res = await Lum0x.farcasterUser.getPowerUsers({
    limit: 3
});
console.log(JSON.stringify(res, null, 2));

Response

{
  "users": [
    {
      "object": "user",
      "fid": 2,
      "custody_address": "0x4114e33eb831858649ea3702e1c9a2db3f626446",
      "username": "v",
      "display_name": "Varun Srinivasan",
      "pfp_url": "https://i.seadn.io/gae/sYAr036bd0bRpj7OX6B-F-MqLGznVkK3--DSneL_BT5GX4NZJ3Zu91PgjpD9-xuVJtHq0qirJfPZeMKrahz8Us2Tj_X8qdNPYC-imqs?w=500&auto=format",
      "profile": {
        "bio": {
          "text": "Technowatermelon. Elder Millenial. Building Farcaster. \n\nnf.td/varun"
        }
      },
      "follower_count": 400141,
      "following_count": 1297,
      "verifications": [
        "0x91031dcfdea024b4d51e775486111d2b2a715871",
        "0x182327170fc284caaa5b1bc3e3878233f529d741",
        "0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x91031dcfdea024b4d51e775486111d2b2a715871",
          "0x182327170fc284caaa5b1bc3e3878233f529d741",
          "0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0"
        ],
        "sol_addresses": [
          "9t92xZy9q5SyfKBH4rZwEDFXjaZKgzj5PgviPhKtBjyy"
        ]
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 3,
      "custody_address": "0x6b0bda3f2ffed5efc83fa8c024acff1dd45793f1",
      "username": "dwr.eth",
      "display_name": "Dan Romero",
      "pfp_url": "https://res.cloudinary.com/merkle-manufactory/image/fetch/c_fill,f_png,w_256/https://lh3.googleusercontent.com/MyUBL0xHzMeBu7DXQAqv0bM9y6s4i4qjnhcXz5fxZKS3gwWgtamxxmxzCJX7m2cuYeGalyseCA2Y6OBKDMR06TWg2uwknnhdkDA1AA",
      "profile": {
        "bio": {
          "text": "Working on Farcaster and Warpcast."
        }
      },
      "follower_count": 475876,
      "following_count": 3379,
      "verifications": [
        "0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    },
    {
      "object": "user",
      "fid": 8,
      "custody_address": "0xc6e3004b0e54a91da8d87ace80b6abc64d23e33f",
      "username": "jacob",
      "display_name": "jacob",
      "pfp_url": "https://i.imgur.com/tt8uLVd.jpg",
      "profile": {
        "bio": {
          "text": "Working on /zora, zora.co.\n +++???!!!"
        }
      },
      "follower_count": 424901,
      "following_count": 328,
      "verifications": [
        "0x17cd072cbd45031efc21da538c783e0ed3b25dcc"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x17cd072cbd45031efc21da538c783e0ed3b25dcc"
        ],
        "sol_addresses": []
      },
      "active_status": "inactive",
      "power_badge": true
    }
  ],
  "next": {
    "cursor": "eyJmaWQiOjN9"
  }
}

Field	User 1	User 2	User 3
Object	user	user	user
FID	2	3	8
Custody Address	0x4114e33eb831858649ea3702e1c9a2db3f626446	0x6b0bda3f2ffed5efc83fa8c024acff1dd45793f1	0xc6e3004b0e54a91da8d87ace80b6abc64d23e33f
Username	v	dwr.eth	jacob
Display Name	Varun Srinivasan	Dan Romero	jacob
Profile Pic URL
Bio	Technowatermelon. Elder Millenial. Building Farcaster. nf.td/varun	Working on Farcaster and Warpcast.	Working on /zora, zora.co. +++???!!!
Follower Count	400,141	475,876	424,901
Following Count	1,297	3,379	328
Verifications	0x91031dcfdea024b4d51e775486111d2b2a715871 0x182327170fc284caaa5b1bc3e3878233f529d741 0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0	0xd7029bdea1c17493893aafe29aad69ef892b8ff2	0x17cd072cbd45031efc21da538c783e0ed3b25dcc
Verified ETH Addresses	0x91031dcfdea024b4d51e775486111d2b2a715871 0x182327170fc284caaa5b1bc3e3878233f529d741 0xf86a7a5b7c703b1fd8d93c500ac4cc75b67477f0	0xd7029bdea1c17493893aafe29aad69ef892b8ff2	0x17cd072cbd45031efc21da538c783e0ed3b25dcc
Verified SOL Addresses	9t92xZy9q5SyfKBH4rZwEDFXjaZKgzj5PgviPhKtBjyy	없음	없음
Active Status	inactive	inactive	inactive
Power Badge	true	true	true

Field Description

• Object: The type of data object.

• FID: The user's unique identifier.

• Custody Address: The user's wallet address.

• Username: The user's account name.

• Display Name: The user's public name.

• Profile Pic URL: The URL of the user's profile picture.

• Bio: Information about the user, including introductions and links.

• Follower Count: The number of followers the user has.

• Following Count: The number of people the user is following.

• Verifications: The user's verification information.

• Verified ETH Addresses: List of verified Ethereum addresses.

• Verified SOL Addresses: List of verified Solana addresses.

• Active Status: The user's activity status (e.g., active, inactive).

• Power Badge: Whether the user holds a power badge.