> For the complete documentation index, see [llms.txt](https://docs.nexus.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.xyz/api-reference/account/fetch-deposit-target-v1.md).

# GET /api/v1/account/deposit-target

How to fund this account.

`operationId`: `fetchDepositTargetV1` · CCXT method: `fetchDepositAddress`

**Authentication:** `hmacAuth`.

Machine-readable funding instructions for the authenticated account, so an autonomous client can fund itself without out-of-band knowledge of how a given deployment accepts collateral.

**The response is a discriminated union on `mode`, and which mode you get is a property of the deployment, not of the request.** Branch on `mode`; do not assume either shape. A deployment with a real deposit-contract address configured answers `onchain`; otherwise it answers `testnet-faucet` and points at its synthetic-credit endpoints. There is no request parameter that selects between them.

An address is never fabricated to fill the `onchain` shape. A deployment configured for on-chain deposits whose address is malformed refuses with `503` rather than silently falling back to the faucet, because depositing to a bad address burns the funds.

`confirm` is identical in both modes and is the portable primitive: poll `GET /account` until `balance` reflects the funds.

This operation is **discovery only**. It moves no funds, creates no deposit, and has no side effect — acting on the returned `faucet` or `onchain` instruction is a separate, explicit step by the caller.

## Responses

| Status | Body                                                              | Meaning                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `200`  | [`DepositTarget`](/api-reference/guides/schemas.md#deposittarget) | Funding instructions for the authenticated account. Exactly one `mode` is returned; the fields beyond the common ones depend on it.                                                                                                                                                                                                                                                                                                                                                                                                              |
| `401`  | — *(no schema declared)*                                          | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `403`  | — *(no schema declared)*                                          | Refused with `EARLY_ACCESS_REQUIRED`: this deployment restricts funding to early-access participants and the authenticated account is not one. Permanent for that account until it is enrolled — do not retry. The gate deliberately mirrors `POST /account/credit` and `POST /faucet`, so an account that cannot be funded is not told how to fund. Deployments with early access disabled never return it. The contract-wide `RESTRICTED_JURISDICTION` refusal can also surface as a `403` on any operation — see “Jurisdiction restrictions”. |
| `429`  | — *(no schema declared)*                                          | —                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `503`  | — *(no schema declared)*                                          | `DEPOSIT_TARGET_MISCONFIGURED`: the deployment is configured for on-chain deposits but its deposit-contract address is not a well-formed address, so no funding target can be published. This is an operator misconfiguration rather than a transient fault; retrying does not clear it, and the endpoint deliberately refuses rather than answering `testnet-faucet`, which would mask the bad configuration.                                                                                                                                   |

## Example

```bash
curl -X GET 'https://exchange.nexus.xyz/api/exchange/api/v1/account/deposit-target' \
  -H 'X-API-Key: nx_7f3a1b...' \
  -H 'X-Timestamp: 1776033911836' \
  -H 'X-Signature: <hmac-sha256>'
```

***

<sub>Generated from</sub> <sub></sub><sub>`eng/apps/exchange/api/openapi.json`</sub> <sub></sub><sub>(spec</sub> <sub></sub><sub>`0.9.27`</sub><sub>). Do not edit by hand — regenerate with</sub> <sub></sub><sub>`python3 product/docs/tools/api-reference/generate.py`</sub><sub>. Hand-authored context lives in the Guides pages.</sub>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.nexus.xyz/api-reference/account/fetch-deposit-target-v1.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.