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

# Deposit addresses

> Persistent onchain addresses that auto-route incoming crypto to a wallet.

A deposit address is a monitored blockchain address assigned to a customer's wallet. When crypto arrives at the address, OMS automatically creates and executes a transaction, no developer action required after setup.

<Note>
  Programmatic deposit address provisioning is not yet available in the OMS API. To be notified when it launches, register your interest.

  <Card title="Register interest" icon="envelope" href="https://info.polygon.technology/get-early-access?utm_source=docs&utm_medium=card&utm_campaign=oms_access">
    Share your use case and we'll reach out when programmatic deposit address provisioning is available.
  </Card>
</Note>

Deposit addresses do not expire. OMS keeps them active until they are paused or removed.

## Object

```json theme={null}
{
  "id": "da_...",
  "object": "depositAddress",
  "customerId": "cst_...",
  "status": "active",
  "transactionType": "cryptoToCrypto",
  "source": {
    "asset": "usdc",
    "network": "polygon",
    "depositInstructions": {
      "address": "0xabc123...",
      "asset": "usdc",
      "network": "polygon"
    }
  },
  "destination": {
    "wallet": { "wallet": "wlt_..." },
    "asset": "usdc",
    "network": "polygon"
  },
  "createdAt": "2025-01-15T10:32:00Z"
}
```

Give your customers the `depositInstructions.address` to display in your UI. Any supported asset sent to that address is automatically routed to the linked wallet.

## How it differs from a wallet address

A customer's wallet also has an `address` field, but direct deposits to a wallet address only trigger a `wallet.depositDetected` event, OMS does not auto-convert or route the funds. Deposit addresses are the correct pattern when you want OMS to act on incoming crypto.

|                       | Wallet address                      | Deposit address                       |
| --------------------- | ----------------------------------- | ------------------------------------- |
| OMS action on deposit | `wallet.depositDetected` event only | Auto-creates and executes transaction |
| Routing configuration | None                                | Asset, network, destination wallet    |
| Reusable              | Yes                                 | Yes                                   |

## Status lifecycle

| Status    | Meaning                                          |
| --------- | ------------------------------------------------ |
| `active`  | Monitoring for incoming deposits                 |
| `paused`  | Temporarily inactive; deposits are not processed |
| `deleted` | Permanently removed                              |

## Provisioning

Deposit addresses are provisioned by Polygon during onboarding and early access. In the sandbox, a simulation endpoint `POST /deposit-addresses/{depositAddressId}/simulate` is available for testing inbound transfers.

## Related

* [Deposit addresses guide](/payments/guides/deposit-addresses): full walkthrough with request/response and webhook handling
* [Virtual accounts](/payments/virtual-accounts): same concept for fiat: a bank account number that auto-converts to USDC