Skip to main content
POST
/
wallets
Create Wallet
curl --request POST \
  --url https://api.caminotreasury.com/v1/wallets \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "label": "<string>"
}
'
{
  "address": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "label": "<string>"
}

Authorizations

x-api-key
string
header
required

API key for authentication. Pass your key in the x-api-key header.

Headers

Idempotency-Key
string
required

Caller-chosen string (≤256 chars) that uniquely identifies this request. Resending the same key replays the original response; reusing the same key with a different body returns 422. Keys are scoped per organization.

Required string length: 1 - 256

Body

application/json
label
string

Human-readable name. If omitted, the server assigns Wallet N where N is the next available number for the organization.

Required string length: 1 - 100

Response

Wallet created

address
string
required

Ethereum wallet address (lowercase). Used as the wallet's identifier across the API.

Example:

"0x742d35cc6634c0532925a3b844bc454e4438f44e"

createdAt
string<date-time>
required

Creation timestamp

updatedAt
string<date-time>
required

Last update timestamp

label
string | null

Optional human-readable label