API ReferenceWallets

List addresses

View as MarkdownOpen in Claude

Returns { chain: address } for every wallet the user has. The only endpoint that takes no assetId. A chain missing from the map was not configured when the user was created — fix it with /extend.

Authentication

AuthorizationBearer

A 15-minute token from /auth. Required on every endpoint except /auth.

Headers

X-Request-IdstringOptional
Correlation id. Generated if omitted, echoed on every response, and written to the audit log.
X-USER-IDstringOptionalformat: "^[0-9a-fA-F]{24}$"

Sent by the trusted gateway. When present it overrides any userId in the body.

Request

This endpoint expects an object.
userIdstringRequiredformat: "^[0-9a-fA-F]{24}$"

24-character hex id, returned by /create.

Response

OK
resultmap from strings to strings
One address per chain the user holds a wallet on.
requestIdstring

Echo of the inbound X-Request-Id, or a generated one.

Errors

400
Bad Request Error
401
Unauthorized Error