Skip to main content
A wallet is an on-chain address associated with your partner account. Tokens sent to it are credited to your balance automatically; tokens you pay out leave from it.
Every example on this page is a signed request. $SIGNATURE is computed per request over a canonical string — see Authentication. Bearer tokens are not accepted.

​
One address, two assets

USDSM and EURSM are both Etherlink tokens, and your account holds them at the same address. The endpoint returns an entry per asset because that is what will stay true as more assets and chains are added — not because the addresses differ today.
Do not assume that will always hold. Read the entry whose asset and chain match what you are about to send, and use the address from that entry. An integration that caches one address and reuses it for everything works today and breaks silently the first time an asset is added on different terms — and a transfer sent to the wrong address cannot be reversed by StableMint.

​
Inbound tokens credit automatically

When tokens arrive at your wallet, StableMint records the transfer and credits your balance without any further call from you. The transaction appears in Transactions with method: "Token" and transactionType: "TokenTransferIn". Subscribe to transaction.status.changed if you want to be told when it lands rather than polling — see Receiving webhooks. There is no inbound-transfer-specific event.
This endpoint was previously published as GET /v1/details, which returned a single address alongside your company name. It was renamed because “details” described the shape of the response rather than the resource, and because one address could not represent a partner holding more than one asset.