> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluvo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# wallet.created

> Sent when a wallet is connected to your project via OAuth or API key

## 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

```json Example payload theme={null}
{
  "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`                    |

<Info>
  A `wallet.balance.updated` event typically follows shortly after `wallet.created`, once the initial balance sync completes.
</Info>