Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Onchain

Relevant owners

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".

get/v2/farcaster/fungible/owner/relevant/

Query parameters

contract_addressstring required
Example:0x0db510e79909666d6dec7f5e49370838c16d950f

Contract address of the fungible asset

network'ethereum' | 'optimism' | 'base' | 'arbitrum' required

Network of the fungible asset.

viewer_fidinteger

If you provide a viewer_fid, the response will include token holders from the user's network, respecting their mutes and blocks and including viewer_context; if not provided, the response will show top token holders across the network—both sets can be combined to generate a longer list if desired.

Response

Success

Example response

{
  "all_relevant_fungible_owners_dehydrated": [
    {
      "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "fid": 3
    }
  ],
  "top_relevant_fungible_owners_hydrated": [
    {
      "auth_addresses": [
        {
          "address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
          "app": {
            "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
            "fid": 3
          }
        }
      ],
      "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
      "fid": 3,
      "profile": {
        "bio": {
          "mentioned_profiles": [
            {
              "custody_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
              "fid": 3
            }
          ]
        }
      },
      "verifications": [
        "0x5a927ac639636e534b678e81768ca19e2c6280b7"
      ],
      "verified_addresses": {
        "eth_addresses": [
          "0x5a927ac639636e534b678e81768ca19e2c6280b7"
        ],
        "primary": {
          "eth_address": "0x5a927ac639636e534b678e81768ca19e2c6280b7"
        }
      }
    }
  ]
}