---
title: "Provision an on-chain deposit address"
method: POST
path: "/v1/accounts/{id}/onchain-addresses"
tags: ["Accounts"]
---

# Provision an on-chain deposit address

`POST /v1/accounts/{id}/onchain-addresses`

## Request

- Base URL: `https://api.tesser.xyz`
- URL: `https://api.tesser.xyz/v1/accounts/{id}/onchain-addresses`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tesser/apis/tesser-api/docs/v1/accounts/:id/onchain-addresses/post.ts> (a function with typed inputs; its response is checked against the schema)

Get or create the on-chain deposit address for a ledger account on the given network. Unsupported accounts or networks return a structured error.

Repeated calls may return an existing address or provision one according to the provider's rules.

Retrieving an address does not create a deposit or payment, or credit a balance.

**Warning: do not send funds directly to this address.** Always move funds through the Tesser API.

## Path parameters

- `id` string, required

## Request body

- CreateOnchainAddressRequestDto
  - `network` string: Network for the deposit address. Supported networks depend on the ledger's provider and environment.
  - `currency` 'USDC', required: Currency for the deposit address

## Response `201`

Deposit address provisioned

- CreateOnchainAddressResponseDto
  - `data` OnchainAddressData, required
    - `account_id` string, uuid, required: Ledger account the deposit address belongs to
    - `address` string, required: On-chain deposit address
    - `network` string, required: Network of the deposit address
    - `currency` string, required: Currency of the deposit address

## Other responses

- `400`: Invalid request data
- `401`: Authentication required or invalid credentials
- `403`: Access denied - insufficient permissions
- `404`: Resource not found
- `500`: Internal server error
- `502`: Provider request failed

## Changes

- **2026-11-07** `14f951e986b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tesser/apis/tesser-api/changes/v1/accounts/:id/onchain-addresses/post.md)

---

[API](https://skmtc.dev/tesser/apis/tesser-api.md) - [All operations](https://skmtc.dev/tesser/apis/tesser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tesser/apis/tesser-api/revisions/46461e694e2a?raw)