Which handle a wallet is attributed to

GET/api/v1/lookup/{address}

The reverse of resolve. The deployment's Wallet record answers first, whatever the source (a wallet linked from the terminal or curated is found, not only the on-chain primary binding); without one, the Identity Registry's lookup. An address linked to nothing is a 200 with handle null, not a 404: the address is valid, it is just not linked. When neither layer could be asked, a 503, never a null that reads as 'not linked'.

Parameters

Parameters
Name	In	Type	Description
address	path	string	Stellar account address (G...). A C... contract ID is a 400.

Example request

curl example

curl -s -H "Accept: application/json" "https://signet-web-pearl.vercel.app/api/v1/lookup/GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN"

@signet/sdk example

import { SignetClient } from '@signet/sdk';

const signet = new SignetClient({ baseUrl: 'https://signet-web-pearl.vercel.app' });
const result = await signet.lookupAddress('GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN');

Responses

200 · The handle the wallet is attributed to, or null.

Fields of a 200 response
Field	Type	Description
data	object
address	string
handle	string \| null	The handle, lowercase; null when the wallet is not linked.
isPrimary	boolean	Whether it is the handle's primary (on-chain bound) wallet.
network	string	Network name.
source	string \| null	How the wallet was linked: 'onchain', 'cli' or 'curated' (an open set); null when not linked.
meta	object
source	"database" \| "chain"	Which layer answered.

400 · Not a G... account address (a C... contract ID points to the contract endpoints).

429 · Rate limit exceeded.

500 · Internal server error.

503 · Neither the database nor the registry could be asked.

Example response

Generated from the schema; real values differ.

example response

{
  "data": {
    "address": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
    "handle": "alice",
    "isPrimary": false,
    "network": "string",
    "source": "string"
  },
  "meta": {
    "source": "database"
  }
}