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

Field	Type	Description
`data.wallet.id`	`string`	Unique wallet identifier
`data.wallet.projectId`	`string`	Project the wallet belongs to
`data.wallet.exchange`	`string`	Exchange identifier (e.g., `coinbase`, `binance`, `kraken`)
`data.wallet.type`	`string`	Connection method — `oauth2` or `apikey`

A wallet.balance.updated event typically follows shortly after wallet.created, once the initial balance sync completes.

Retries & Delivery Logs wallet.balance.updated

Overview

Events

wallet.created

wallet.created

When this event is sent

Payload

Fields

​wallet.created

​When this event is sent

​Payload

​Fields

wallet.created

When this event is sent

Payload

Fields