Skip to main content

​
wallet.created

Fired when a user successfully connects an exchange wallet to your project, either through the OAuth flow or by providing API credentials.

​
When this event is sent

  • A user completes the OAuth authorization flow for an exchange
  • A user connects a wallet using an API key and secret

​
Payload

Example payload
{
  "event": "wallet.created",
  "eventId": "wal_abc123",
  "timestamp": "2026-04-21T12:00:00.000Z",
  "data": {
    "wallet": {
      "id": "wal_abc123",
      "projectId": "proj_xyz",
      "exchange": "coinbase",
      "type": "oauth2"
    }
  }
}

​
Fields

FieldTypeDescription
data.wallet.idstringUnique wallet identifier
data.wallet.projectIdstringProject the wallet belongs to
data.wallet.exchangestringExchange identifier (e.g., coinbase, binance, kraken)
data.wallet.typestringConnection method — oauth2 or apikey
A wallet.balance.updated event typically follows shortly after wallet.created, once the initial balance sync completes.