v4

latestOpenAPI 3.1.02026-08-01131465.2 KB
Projects

List a project's buyers

Returns a cursor-paginated page of a project's buyers, ordered by follower count (highest first). When the request's API key owns the project, each buyer additionally carries maxSpendUsdc & maxFdvUsdc.

get/api/public/v1/projects/{slug}/buyers

Path parameters

slugstring required

URL-safe identifier of the project.

Example:yurts-by-nurt

URL-safe identifier of the project.

Query parameters

cursorstring

Opaque cursor marking where the previous page ended. Omit it to fetch the first page; pass the meta.nextCursor from a response verbatim to fetch the next. A null meta.nextCursor means there are no more pages. Treat the value as opaque — its format varies per endpoint.

Opaque cursor marking where the previous page ended. Omit it to fetch the first page; pass the meta.nextCursor from a response verbatim to fetch the next. A null meta.nextCursor means there are no more pages. Treat the value as opaque — its format varies per endpoint.

limitinteger nullable

Maximum number of items per page. Defaults to 20; values are clamped to 1–100.

Maximum number of items per page. Defaults to 20; values are clamped to 1–100.

Response

A page of buyers.

Example response

{
  "data": [
    {
      "source": "farcaster",
      "fid": 3324275,
      "username": "nurt",
      "followerCount": 1240,
      "maxSpendUsdc": "250",
      "maxFdvUsdc": "1000000"
    }
  ],
  "meta": {
    "limit": 20
  }
}