IBExWalletAPI

Quick Start

Quick Start

Get started with the IBEx Wallet API in 5 minutes.

1. Get your API key

Contact the IBEx team to get your API key and configure your project.

2. Create a wallet (Passkey mode)

# Step 1: Start signup
curl -X GET "https://your-domain.ibex.fi/v1.2/auth/sign-up?wallet=passkeys"
 
# Response: credentialRequestOptions
# Pass this to navigator.credentials.create() in the browser
 
# Step 2: Complete signup
curl -X POST "https://your-domain.ibex.fi/v1.2/auth/sign-up" \
  -H "Content-Type: application/json" \
  -d '{"credential": "..."}'

3. Sign in

# Step 1: Start sign-in
curl -X GET "https://your-domain.ibex.fi/v1.2/auth/sign-in"
 
# Response: credentialRequestOptions
# Pass this to navigator.credentials.get() in the browser
 
# Step 2: Complete sign-in
curl -X POST "https://your-domain.ibex.fi/v1.2/auth/sign-in" \
  -H "Content-Type: application/json" \
  -d '{"credential": "..."}'

4. Execute a transaction

curl -X POST "https://your-domain.ibex.fi/v1.2/safes/operations" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "safeAddress": "0x...",
    "to": "0x...",
    "value": "1000000000000000000",
    "data": "0x"
  }'

Authentication modes

The API supports 4 authentication modes:

Modewallet=Use case
Passkeyspasskeys (default)Biometric/security key — most secure
KDFkdfPIN/password-derived key — no biometrics needed
EmailemailEmail OTP + encrypted backup — email-first onboarding
EOA+77027702Existing EOA wallet → Smart Account upgrade

See the API Reference for full endpoint documentation.

On this page