---
title: "Relevant owners"
method: GET
path: "/v2/farcaster/fungible/owner/relevant/"
tags: ["Onchain"]
---

# Relevant owners

`GET /v2/farcaster/fungible/owner/relevant/`

Fetch a list of relevant owners for a on chain asset. If a viewer is provided, only relevant holders will be shown. This usually shows on a fungible asset page as "X, Y, Z and N others you know own this asset".

## Query parameters

- `contract_address` string, required
- `network` 'ethereum' | 'optimism' | 'base' | 'arbitrum', required
- `viewer_fid` integer

## Response `200`

Success

- RelevantFungibleOwnersResponse
  - `all_relevant_fungible_owners_dehydrated` UserDehydrated[], required
    - `custody_address` string — Ethereum address
    - `display_name` string, nullable
    - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
    - `object` 'user_dehydrated', required
    - `pfp_url` string, nullable
    - `score` number
    - `username` string
  - `top_relevant_fungible_owners_hydrated` User[], required
    - `auth_addresses` object[], required
      - `address` string, required — Ethereum address
      - `app` UserDehydrated, required
        - `custody_address` string — Ethereum address
        - `display_name` string, nullable
        - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
        - `object` 'user_dehydrated', required
        - `pfp_url` string, nullable
        - `score` number
        - `username` string
    - `custody_address` string, required — Ethereum address
    - `display_name` string, nullable
    - `experimental` object
      - `deprecation_notice` string
      - `neynar_user_score` number, double, required — Score that represents the probability that the account is not spam.
    - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
    - `follower_count` integer, required — The number of followers the user has.
    - `following_count` integer, required — The number of users the user is following.
    - `object` 'user', required
    - `pfp_url` string, nullable — The URL of the user's profile picture
    - `pro` object
      - `expires_at` string, date-time, required
      - `status` 'subscribed' | 'unsubscribed', required — The subscription status of the user
      - `subscribed_at` string, date-time, required
    - `profile` object, required
      - `banner` object
        - `url` string, uri — The URL of the user's banner image
      - `bio` object, required
        - `mentioned_channels` ChannelDehydrated[]
          - `id` string, required
          - `image_url` string
          - `name` string, required
          - `object` 'channel_dehydrated', required
          - `viewer_context` ChannelUserContext — Adds context on the viewer's or author's role in the channel.
            - `following` boolean, required — Indicates if the user is following the channel.
            - `role` 'member' | 'moderator' | 'owner' — The role of a channel member
        - `mentioned_channels_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_channels list.
          - `end` number, required
          - `start` number, required
        - `mentioned_profiles` UserDehydrated[]
          - `custody_address` string — Ethereum address
          - `display_name` string, nullable
          - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
          - `object` 'user_dehydrated', required
          - `pfp_url` string, nullable
          - `score` number
          - `username` string
        - `mentioned_profiles_ranges` TextRange[] — Positions within the text (inclusive start, exclusive end) where each mention occurs. Each index within this list corresponds to the same-numbered index in the mentioned_profiles list.
          - `end` number, required
          - `start` number, required
        - `text` string, required
      - `live_at` object
        - `is_live` boolean, required
        - `updated_at` string, date-time, required
        - `url` string, required — The URL of the user's current live activity
      - `location` Location — Coordinates and place names for a location
        - `address` LocationAddress
          - `city` string, required
          - `country` string, required
          - `country_code` string
          - `state` string
          - `state_code` string
        - `latitude` number, double, required
        - `longitude` number, double, required
        - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
    - `registered_at` string, date-time, required
    - `score` number, double — Score that represents the probability that the account is not spam.
    - `username` string, required
    - `verifications` EthAddress[], required
    - `verified_accounts` object[], required
      - `platform` 'x' | 'github'
      - `username` string
    - `verified_addresses` object, required
      - `eth_addresses` EthAddress[], required — List of verified Ethereum addresses of the user sorted by oldest to most recent.
      - `primary` object, required
        - `eth_address` string, required — Ethereum address
        - `sol_address` string, required — Solana address
      - `sol_addresses` SolAddress[], required — List of verified Solana addresses of the user sorted by oldest to most recent.
    - `viewer_context` UserViewerContext — Adds context on the viewer's follow relationship with the user.
      - `blocked_by` boolean, required — Indicates if the viewer is blocked by the user.
      - `blocking` boolean, required — Indicates if the viewer is blocking the user.
      - `followed_by` boolean, required — Indicates if the viewer is followed by the user.
      - `following` boolean, required — Indicates if the viewer is following the user.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/neynar/apis/neynar-api.md) · [All operations](https://skmtc.net/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)