Skip to main content
POST
Use this endpoint to provision an additional custodial (internal) address on an account beyond the wallets Brale creates automatically at onboarding. This is useful when you want to segment funds within a single account (per end-user, per-purpose, or per-business-unit) and distinguish wallets by name.
Requires the addresses:write scope and a unique Idempotency-Key header on every request.
All values in transfer_types must resolve to the same chain environment (for example ["ethereum", "polygon"] for EVM, or ["stellar"] for Stellar).

Request

Request (EVM)
Request (Stellar)

Responses

Deterministic-address chains (Solana, Stellar, Ethereum, Base, Polygon) return synchronously with status: "active" and a non-null address.
201 (synchronous)
Non-deterministic chains (Spark, Canton, Hedera) return status: "pending" and address: null until the chain confirms. The address transitions to active once provisioning completes — see Address lifecycle.
201 (asynchronous)
Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.

Authorizations

Authorization
string
header
required

Use the Bearer token returned from the Auth endpoint via OAuth2 client_credentials flow. Include the token in the "Authorization: Bearer " header.

Headers

Idempotency-Key
string
required

A unique string used to prevent duplicate operations. Each POST request must use a new idempotency key. Use a UUIDv4 string. Example: idemp-123e4567-e89b-12d3-a456-426614174000

Path Parameters

account_id
string<ksuid>
required

The ID of the account

Pattern: ^[a-zA-Z0-9]{27}$
Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"

Body

application/json
transfer_types
string[]
required

One or more transfer types that must all resolve to the same chain environment (e.g. ["ethereum","polygon"] for EVM, ["stellar"] for Stellar).

Minimum array length: 1
name
string | null
required

A human-readable name for the new internal address.

Response

201 - */*

Internal address successfully created

id
string<ksuid>
Pattern: ^[a-zA-Z0-9]{27}$
Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"

status
enum<string>
Available options:
pending,
active,
archived
Example:

"active"

name
string
Example:

"Solana Custodial Wallet"

address
string

The on-chain wallet address

Example:

"73uyt9HkEqx9bThYXWaUBP67sWsiJEsyJ5rSCieDx5me"

transfer_types
string[]
Example: