post deprecated
https://api.lirium-sandbox.com/v1/customers//receiving_addresses
Generate a cryptocurrency receiving address for a customer
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Generate a unique cryptocurrency receiving address for a customer. Funds sent to this address will be credited to the customer's account.
Request
POST /customers/{customer_id}/receiving-addresses
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
customer_id | string | Yes | Customer ID |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
currency | string | Yes | Cryptocurrency code (e.g., BTC, ETH) |
network | string | No | Blockchain network (required for multi-network currencies) |
Example Request
{
"currency": "BTC"
}Example Response
{
"id": "addr_abc123",
"customer_id": "cust_xyz789",
"currency": "BTC",
"network": "bitcoin",
"address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh",
"created_at": "2025-01-05T12:00:00Z"
}Notes
- If an address already exists for the customer and currency combination, the existing address is returned
- Addresses are permanent and do not expire
- All incoming transactions to the address will generate
receiveorders - Use List Receiving Addresses to retrieve existing addresses