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".
Onchain
Fetch Relevant Fungible Owners is an example object payload from Neynar, with 9 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
{
"operationId": "fetch-relevant-fungible-owners",
"method": "GET",
"path": "/v2/farcaster/fungible/owner/relevant/",
"summary": "Relevant owners",
"description": "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\".",
"tags": [
"Onchain"
],
"parameters": [
{
"name": "contract_address",
"in": "query",
"required": true,
"description": "Contract address of the fungible asset (Ethereum or Solana)",
"schema": {
"example": "0x0db510e79909666d6dec7f5e49370838c16d950f (eth) --OR-- EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (solana)",
"type": "string"
}
},
{
"name": "network",
"in": "query",
"required": true,
"description": "Network of the fungible asset.",
"schema": {
"enum": [
"ethereum",
"optimism",
"base",
"arbitrum",
"solana"
],
"title": "FungibleOwnerRelevantNetwork",
"type": "string"
}
},
{
"name": "viewer_fid",
"in": "query",
"required": false,
"description": "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\u2014both sets can be combined to generate a longer list if desired.",
"schema": {
"minimum": 1,
"type": "integer"
}
}
],
"requestBody": null,
"responses": {
"200": {
"description": "Success",
"schema": {
"$ref": "#/components/schemas/RelevantFungibleOwnersResponse"
},
"example": null
},
"400": {
"description": "Bad Request",
"schema": {
"$ref": "#/components/schemas/ErrorRes"
},
"example": null
}
}
}