# 取得存款地址

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

端點： `POST /getDepositAddress`

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

請求參數：

| 參數          | 類別                                                                               | 需要 | 說明                         |
| ----------- | -------------------------------------------------------------------------------- | -- | -------------------------- |
| network     | [NetworkSymbol](/traditional-chinese/secureapi/can-kao-zi-liao.md#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](/traditional-chinese/secureapi/can-kao-zi-liao.md#networksymbol) | 是  | L1 網路 (例如 `ETH`)                |
| identifier        | string                                                                           | 是  | UserID 或類似識別碼 (identifier)      |
| referenceId       | string                                                                           | 是  | 可選的參考 ID 用於識別存款訂單               |
| requestedCurrency | [Currency](/traditional-chinese/secureapi/can-kao-zi-liao.md#huo-bi)             | 是  | 要求的貨幣（例如 `USDT`、`USDC`、`USD`）   |
| requestedAmount   | string                                                                           | 是  | 要求的金額（以字串形式，以避免精確度問題）           |
| token             | [TokenSymbol](/traditional-chinese/secureapi/can-kao-zi-liao.md#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"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akashicpay.com/traditional-chinese/secureapi/han-shi-functions/qu-de-cun-kuan-di-zhi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.