Skip to main content
POST
Register a self-attested wallet address

Authorizations

X-API-Key
string
header
required

API Key

Headers

IDEMPOTENCY-KEY
string
required

a UUID ensuring an address is only registered once

X-SUB-PARTNER-ID
string

Optional sub-partner UUID, if provided, the wallet address will be registered for the sub-partner

X-API-Version
string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01.

Body

application/json; charset=utf-8

The self-attested wallet registration request

Self-attested wallet registration request

Register a self-hosted wallet the customer declares as their own, without a cryptographic signature. For direct customers who can't sign from a custody UI (e.g. Fireblocks). Scoped to US and RoW customers.

address
string
required

The address of the wallet

blockchain
enum<string>
required

Blockchain

A type of blockchain

Available options:
Solana,
Ethereum,
Polygon,
Arbitrum,
Base,
Stellar,
Citrea,
Plasma,
Avalanche,
Moca,
Tempo,
Tron,
Bsc
customer_id
string<uuid>
required

The customer ID

name
string

Optional display name for this wallet address

Response

POST Self-Attested Wallet Succeeded

Verified Address Response

Response containing verified address details

address_type
enum<string>
required
Available options:
Hosted,
SelfHosted
blockchain
enum<string>
required

Blockchain

A type of blockchain

Available options:
Solana,
Ethereum,
Polygon,
Arbitrum,
Base,
Stellar,
Citrea,
Plasma,
Avalanche,
Moca,
Tempo,
Tron,
Bsc
created_at
string<date-time>
required

When the address was verified

disabled
boolean
required

Whether the address is disabled

id
string<uuid>
required

The ID of the verified address

is_self
boolean
required

Whether the wallet belongs to the customer themselves (true) or a third party

wallet_address
string
required

The wallet address

name
string

Optional display name for this wallet address

proof_message
string

The proof message

proof_signature
string

The proof signature

vasp_did
string

The VASP DID (decentralized Identifier) for hosted wallets