The Address object
The shape of an address wherever the API returns one.
Every endpoint that returns an address returns this shape, wrapped in a data envelope.
Attributes
id
uuid · always presentGyvar's identifier for this address. Stable forever.
chain
enum · always presentA chain that can hold a standing receive address. lightning is deliberately absent - see the Addresses tag. One of: bitcoin, tron, ethereum, polygon, solana, base, bsc.
address
string · always presentThe on-chain address. Send funds here.
assets
array of string · always presentEvery asset this address will credit. Derived from the live catalog, not stored - tron returns ["USDT"], base ["USDC"], ethereum ["USDT","USDC"]. Do not persist a single asset alongside the address. On a multi-asset chain the other one will eventually land on it.
label
string · optional—
reference
string · optional—
created_at
timestamp · always present—
{
"id": "0d6c2f3a-1b4e-4c9a-9f2d-7a1e5c8b3d60",
"chain": "bitcoin",
"address": "0x2f1a9C4b7E3d5A8f6B0c1D4e7A9b2C5d8E3f6A1b",
"assets": [
"USDT",
"USDC"
],
"label": "Ama Owusu",
"reference": "customer_8842",
"created_at": "2026-09-01T10:04:11Z"
}Addresses
Standing on-chain receive addresses.
Create or fetch an address
Get-or-create, keyed on the `reference` you send. Returns 201 when an address was minted and 200 when an existing one was returned; both are success, and the distinction lets you log which happened instead of having to trust us. A retry after a timeout returns the same address rather than minting a second one. `reference` is required. Without one the request would mean "the project's standing address for this chain", and that address is the dashboard's - it is the one a person reads off the Wallet screen.