> ## Documentation Index > Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt > Use this file to discover all available pages before exploring further. # Enable a wallet deposit address > Starts the one-time deposit setup required by certain chains. This endpoint supports Stellar Testnet in sandbox and Stellar mainnet in beta-enabled production environments. The organization must have signing enabled before calling it. Starts the one-time deposit setup required by certain chains. This endpoint supports Stellar Testnet in sandbox and Stellar mainnet in enabled production environments during beta. Configure an organization signer before calling it. A provisioning response means the setup approval or onchain preparation is still in progress. See [Power Yield for Stellar Balances](/docs/portfolio-wallets/integration-guides/stellar) for the complete integration flow. ## OpenAPI ````yaml swagger/swagger-combined.yaml POST /v2/wallets/{id}/deposit-addresses/{chain}/enable openapi: 3.0.0 info: title: Ground API description: Core API for Portfolio Wallets, gtokens, MicroVaults, and webhooks. version: 2.0.0 servers: - url: https://sandbox.groundtech.co - url: https://production.groundtech.co security: - bearerAuth: [] tags: - name: System description: System health and utility endpoints. - name: Sandbox Faucets description: Sandbox-only test token faucets. - name: Portfolio Wallets description: >- Portfolio wallets with strategy allocation, deposits, withdrawals, and yield positions. - name: gVaults description: >- Direct access to gtokens with deposit access controls and optional fee wrappers. - name: MicroVaults description: >- Customer-owned onchain vaults with externally held ERC-20 shares. Private preview in sandbox on Ethereum Sepolia. - name: Webhook Endpoints description: Webhook endpoint management for portfolio wallet notifications. paths: /v2/wallets/{id}/deposit-addresses/{chain}/enable: post: tags: - Portfolio Wallets summary: Enable a deposit address description: >- Starts the one-time deposit setup required by certain chains. This endpoint supports Stellar Testnet in sandbox and Stellar mainnet in beta-enabled production environments. The organization must have signing enabled before calling it. operationId: enableWalletDepositAddressV2 parameters: - name: id in: path required: true schema: type: string format: uuid description: Wallet ID - name: chain in: path required: true schema: type: string enum: - stellar - stellar_testnet description: >- Use `stellar_testnet` in sandbox or `stellar` in a beta-enabled production environment. responses: '200': description: Stellar deposits are ready content: application/json: schema: type: object required: - chain - status - address properties: chain: type: string enum: - stellar - stellar_testnet status: type: string enum: - ready address: type: string description: Stellar G-address for deposits. example: chain: stellar_testnet status: ready address: GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF '202': description: >- Stellar deposit setup is in progress. The response includes `Retry-After: 5`. headers: Retry-After: schema: type: integer description: Suggested seconds before checking the wallet again. content: application/json: schema: type: object required: - chain - status properties: chain: type: string enum: - stellar - stellar_testnet status: type: string enum: - provisioning example: chain: stellar_testnet status: provisioning '400': description: Invalid wallet ID or unsupported chain content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Unsupported chain code: unsupported_chain '401': $ref: '#/components/responses/Unauthorized' '404': description: Wallet not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Wallet not found code: wallet_not_found '409': description: Signing is not enabled or a previous setup attempt failed content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: signing_required: value: error: Enable signing before enabling Stellar deposits code: stellar_customer_approval_unavailable setup_failed: value: error: Stellar deposit setup could not be completed code: stellar_deposit_enablement_failed '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' '503': description: Stellar deposit setup is unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Stellar deposit setup is not enabled in this environment code: stellar_deposit_enablement_unavailable components: schemas: ErrorResponse: type: object required: - error - code properties: error: type: string description: >- Human-readable error message. May change without notice; do not parse programmatically. code: type: string description: >- Machine-readable error code. Stable across API versions — safe to switch on in client code. enum: - validation_error - unknown_parameters - payload_too_large - unsupported_media_type - submission_id_conflict - feedback_unavailable - unsupported_chain - unsupported_token - invalid_destination_address - stellar_destination_account_not_active - stellar_destination_usdc_not_enabled - precision_overflow - invalid_cursor - unauthenticated - forbidden - wallet_not_found - wallet_limit_reached - withdrawal_not_found - deposit_not_found - yield_source_not_found - wallet_projection_unavailable - insufficient_funds - duplicate_request_id - request_id_conflict - invalid_position_weight - invalid_withdrawal_plan - payout_not_found - webhook_not_found - webhook_duplicate_url - withdrawal_not_cancellable - withdrawal_already_cancelled - withdrawal_payout_in_progress - withdrawal_policy_required - workflow_conflict - stale_rebalance_plan - stale_wallet_strategy - payout_already_terminal - payout_in_progress - payout_not_retryable - address_book_entry_not_found - address_book_duplicate_entry - address_book_whitelist_violation - rate_limited - rate_limit_exceeded - internal_error - wallet_creation_failed - service_temporarily_unavailable AuthErrorResponse: type: object required: - error properties: error: type: string description: Authentication or authorization error message. message: type: string nullable: true description: Additional auth middleware detail, when present. code: type: string nullable: true enum: - unauthenticated - forbidden description: >- Some auth and scope failures include a stable code; middleware errors may omit it. responses: Unauthorized: description: >- The request is missing a valid bearer token, or the token is invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthErrorResponse' example: error: Unauthenticated request message: Missing or invalid bearer token TooManyRequests: description: >- Rate limit exceeded. Limits are enforced by API key/customer identity and by endpoint class. Retry with backoff; rate-limit headers are not currently emitted. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Rate limit exceeded code: rate_limited InternalServerError: description: >- An unexpected error occurred while processing the request. The request can be safely retried with the same `requestId`. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Internal server error code: internal_error securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.