# 取得存款地址

### <mark style="color:blue;">取得存款地址 (Get Deposit Address)</mark>

端點： `POST /getDepositAddress`

說明： 擷取使用者在指定網路存款的 L1 地址。

請求參數：

| 參數          | 類別                                                                                             | 需要 | 說明                         |
| ----------- | ---------------------------------------------------------------------------------------------- | -- | -------------------------- |
| network     | [NetworkSymbol](https://docs.akashicpay.com/traditional-chinese/can-kao-zi-liao#networksymbol) | 是  | L1 網路 (例如 `ETH`)           |
| identifier  | string                                                                                         | 是  | UserID 或類似識別碼 (identifier) |
| referenceId | string                                                                                         | 否  | 可選的參考 ID 用於識別存款訂單          |

回應：

```json
{
  "address": "string",
  "identifier": "string"
}
```

### <mark style="color:blue;">以要求的值取得存款地址 (Get Deposit Address With Requested Value)</mark>

端點： `POST /getDepositAddressWithRequestedValue`

說明： 擷取具有要求值的 L1 地址。符合要求值的第一筆存款會觸發 `referenceId`。其他存款會觸發不含 `referenceId` 的回詬調。

請求參數：

| 參數                | 類別                                                                                             | 需要 | 說明                              |
| ----------------- | ---------------------------------------------------------------------------------------------- | -- | ------------------------------- |
| network           | [NetworkSymbol](https://docs.akashicpay.com/traditional-chinese/can-kao-zi-liao#networksymbol) | 是  | L1 網路 (例如 `ETH`)                |
| identifier        | string                                                                                         | 是  | UserID 或類似識別碼 (identifier)      |
| referenceId       | string                                                                                         | 是  | 可選的參考 ID 用於識別存款訂單               |
| requestedCurrency | [Currency](https://docs.akashicpay.com/traditional-chinese/can-kao-zi-liao#huo-bi)             | 是  | 要求的貨幣（例如 `USDT`、`USDC`、`USD`）   |
| requestedAmount   | string                                                                                         | 是  | 要求的金額（以字串形式，以避免精確度問題）           |
| token             | [TokenSymbol](https://docs.akashicpay.com/traditional-chinese/can-kao-zi-liao#tokensymbol)     | 否  | 可選的代幣符號 (例如 `USDT`)             |
| markupPercentage  | number                                                                                         | 否  | 適用於匯率的加價百分比 (最小: -100, 最大: 100) |

回應：

```json
{
  "address": "string",
  "identifier": "string",
  "referenceId": "string",
  "requestedAmount": "string",
  "requestedCurrency": "string",
  "network": "string",
  "token": "string",
  "exchangeRate": "string",
  "amount": "string"
}
```