Artist lookups

Find an artist's X handle

Returns the X handle of an artist found by ethAddress or name. No credentials.

ethAddress wins when both are sent. A 0x address of 40 hex characters is matched exactly against the artist's wallets, then ens; any other value against ens only.

name is a fuzzy search: substring matches first, then trigram similarity of at least 0.3. The best match is used.

result is null when the artist has no X handle. A name that matches no artist returns 200 {}.

Responses are { result } with plain-text errors, not this API's { status } envelope.

POST/api/findTwitterHandle

POST

POST/api/findTwitterHandle

Returns the X handle of an artist found by ethAddress or name. No credentials.

Body

bodyapplication/json

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/findTwitterHandle' \
  --header 'Content-Type: application/json' \
  --data '{
  "ethAddress": "0x0000000000000000000000000000000000000001"
}'

Send the request to see the live response here.

cURL

curl --request POST \
  --url 'https://musicnerd-api.vercel.app/api/findTwitterHandle' \
  --header 'Content-Type: application/json' \
  --data '{
  "ethAddress": "0x0000000000000000000000000000000000000001"
}'

{
  "result": "exampleartist"
}

Authorizations

None. This endpoint is public.

Body

application/jsonrequired

namestring

ethAddressstring

Response

application/json

The artist's X handle, or {} when a name search matches nothing.

resultstring | null