Create a new external address

Creates a non-custodial address (EOA) for the specified account.

POST /accounts/{account_id}/addresses/external

cURL

onchain_base

curl --request POST \ --url https://api.brale.xyz/accounts/{account_id}/addresses/external \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Idempotency-Key: <idempotency-key>' \ --data ' { "name": "Base External Wallet", "transfer_types": [ "base" ], "address": "0xE57e438aE0b1557bFC1ad70BD7751635E473D888" } '

201

{
  "id": "2VcUIIsgARwVbEGlIYbhg6fGG57"
}

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]{26}$

Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"

Body

application/json

CreateExternalBlockchainAddressRequest

CreateExternalFinancialInstitutionRequest

name · string | null · required

Example:

"Company External EVM Address"

address · string · required

Example:

"0xb518d4d6221d9a41d23d71cbce8e106e7aab8f9b"

transfer_types · string[] · required

Response

201 - */*

External address successfully created

id · string<ksuid>

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

Example:

"2VcUIIsgARwVbEGlIYbhg6fGG57"