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

# Wallets

> Your on-chain settlement addresses.

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.

<Note>
  Every example on this page is a signed request. `$SIGNATURE` is computed per request over a canonical string — see [Authentication](/guides/authentication). Bearer tokens are not accepted.
</Note>

```bash theme={null}
curl https://api.stablemint.net/v1/wallets \
  -H "ApiKey: $STABLEMINT_API_KEY" \
  -H "Timestamp: $TIMESTAMP" \
  -H "Nonce: $NONCE" \
  -H "Signature: $SIGNATURE"
```

```json theme={null}
[
  {
    "asset": "USDSM",
    "chain": "Etherlink",
    "address": "0xYourWalletAddress"
  },
  {
    "asset": "EURSM",
    "chain": "Etherlink",
    "address": "0xYourWalletAddress"
  }
]
```

| Field     | Meaning                                              |
| --------- | ---------------------------------------------------- |
| `asset`   | The token this entry describes — `USDSM` or `EURSM`. |
| `chain`   | The network the address lives on. `Etherlink` today. |
| `address` | The on-chain address.                                |

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

<Warning>
  **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.
</Warning>

## 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](/guides/transactions) with `method: "Token"` and `transactionType: "TokenTransferIn"`.

Subscribe to [`transaction.status.changed`](/guides/event-types) if you want to be told when it lands rather than polling — see [Receiving webhooks](/guides/webhooks). There is no inbound-transfer-specific event.

<Note>
  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.
</Note>