Wallets linked to a handle

GET/api/v1/profiles/{handle}/wallets

All wallets attributed to a handle with provenance source and indexing status. Primary wallet is returned first.

Parameters

Parameters
Name	In	Type	Description
handle	path	string	Handle to look up (case-insensitive).

Example request

curl example

curl -s -H "Accept: application/json" "https://signet-web-pearl.vercel.app/api/v1/profiles/alice/wallets"

@signet/sdk example

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

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

Responses

200 · List of linked wallets.

Fields of a 200 response
Field	Type	Description
data	HandleWallet[]
address	string	Stellar account public key (G...) or contract ID (C...).
indexingPending	boolean	True when the indexer has not yet finished scanning the wallet.
isPrimary	boolean	Whether this is the primary wallet for the handle.
linkedAt	string \| null	ISO-8601 UTC timestamp when the link was attested, or null.
network	string	Network context.
source	string	Provenance of the wallet link ('onchain', 'cli', 'curated', or 'unknown').
meta	object
source	string	Layer that answered ('db' or 'chain').

400 · Invalid handle.

404 · No profile for this handle.

429 · Rate limit exceeded.

500 · Internal server error.

Example response

Generated from the schema; real values differ.

example response

{
  "data": [
    {
      "address": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "indexingPending": false,
      "isPrimary": false,
      "linkedAt": "2026-09-20T12:00:00.000Z",
      "network": "string",
      "source": "string"
    }
  ],
  "meta": {
    "source": "string"
  }
}