Skip to main content
POST
Creates a new customer record tied to the authenticated instance. You can either provide a wallet address directly, or omit it to receive a referenceKey that allows linking a wallet later via the Link Wallet endpoint.

Request Body

walletAddress
string
Ethereum wallet address. Must be a valid checksummed or lowercased address. If omitted, a referenceKey is generated for deferred wallet linking.
name
string
Customer display name.
country
string
ISO 3166-1 alpha-2 or alpha-3 country code (e.g., DE, DEU).
investorType
string
default:"RETAIL"
Investor classification. Values: RETAIL, PROFESSIONAL, ELIGIBLE_COUNTERPARTY.
externalId
string
Your own external reference identifier for this customer.
metadata
object
Arbitrary key-value metadata to store with the customer record.

Response Fields

success
boolean
Request status
data
object
The created customer object. Includes referenceKey when no walletAddress was provided.