Skip to main content
POST
Register an external EVM wallet

Authorizations

Authorization
string
header
required

A secret NorthFond business API key. Keep it on your server.

Headers

Idempotency-Key
string
required

A unique key for this logical write operation. Reuse it when retrying the exact same request.

Required string length: 8 - 255

Body

application/json
type
any
required
chain
enum<string>
required
Available options:
base,
polygon,
arbitrum,
optimism,
avalanche
address
string
required
Pattern: ^0x[0-9a-fA-F]{40}$
customer_reference
string
Required string length: 1 - 120
label
string
Maximum string length: 120
asset
any
default:USDC

Response

External wallet registered

id
string<uuid>
required
type
enum<string>
required
Available options:
managed_wallet,
external_wallet
chain
string
required

evm for managed wallets.

supported_chains
enum<string>[]
required
Available options:
base,
polygon,
arbitrum,
optimism,
avalanche
asset
any
required
address
string
required
Pattern: ^0x[0-9a-fA-F]{40}$
ownership_status
enum<string>
required
Available options:
managed,
unverified,
verified
status
enum<string>
required
Available options:
active,
archived
created_at
string<date-time>
required
updated_at
string<date-time>
required
customer_id
string<uuid> | null
customer_reference
string | null
label
string | null
verified_at
string<date-time> | null
archived_at
string<date-time> | null