Skip to main content
POST
Create a wallet

Authorizations

x-api-key
string
header
required

An API key (chance_sk_live_…) from https://harness.chance.cc/keys.

Body

application/json
name
string
required

Unique per account.

mode
enum<string>
required

autonomous executes an ALLOW with a clean simulation. safe holds every proposal for the owner. Safe mode supports Base and Starknet.

Available options:
autonomous,
safe
chain
enum<string>

Required unless chainType is sent.

Available options:
base,
solana,
starknet
chainType
enum<string>

Alternative to chain. ethereum creates a Base wallet.

Available options:
ethereum,
solana,
starknet
mandate
string

Plain-language rules the judge checks each proposal against.

limits
object

Deterministic limits checked against the simulated effects before the judge runs.

Response

The new wallet.

id
string
name
string
chain
enum<string>

ethereum only for wallets created before Base.

Available options:
ethereum,
base,
solana,
starknet
mode
enum<string>
Available options:
autonomous,
safe
custody
enum<string>

embedded: the owner's self-custodial wallet signs. server: a custodian holds the key.

Available options:
server,
embedded
address
string
mandate
string | null
balanceUsd
number | null
tokenCount
integer
pendingCount
integer

Proposals awaiting the owner.

archivedAt
string<date-time> | null
createdAt
string<date-time>