Skip to main content
The useNames hook is used to get multiple names from an onchain identity provider for an array of addresses in a single batch request. It is implemented with useQuery from @tanstack/react-query, and returns a UseQueryResult object, allowing you to pass through all @tanstack/react-query options.

​
Usage

Get ENS names from multiple addresses: 
import { useNames } from '@coinbase/onchainkit/identity';

const addresses = [
  '0x4bEf0221d6F7Dd0C969fe46a4e9b339a84F52FDF',
  '0x838aD0EAE54F99F1926dA7C3b6bFbF617389B4D9'
];
const { data: names, isLoading } = useNames({ addresses });
Get Basenames from multiple addresses: 
import { useNames } from '@coinbase/onchainkit/identity';
import { base } from 'viem/chains';

const addresses = [
  '0x4bEf0221d6F7Dd0C969fe46a4e9b339a84F52FDF',
  '0x4bEf0221d6F7Dd0C969fe46a4e9b339a84F52FDF'
];
const { data: names, isLoading } = useNames({ addresses, chain: base });

​
Returns

useQuery<Promise<GetNameReturnType[]>>

​
Parameters

​
UseNamesOptions

UseNamesOptions

​
UseQueryOptions

UseQueryOptions
⌘I