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

# Generate Deposit Address

> Generate a USDT deposit address to fund your Fyatu business wallet. POST /account/deposit-address.

## Overview

Generate a deposit address for receiving cryptocurrency. Select your preferred currency (USDT or USDC) and network (TRON, ETH, BSC, etc.).

## Supported Currencies

| Currency | Description |
| -------- | ----------- |
| `USDT`   | Tether USD  |
| `USDC`   | USD Coin    |

## Supported Networks

| Network     | Address Type | Compatible Currencies |
| ----------- | ------------ | --------------------- |
| `TRON`      | TRC20        | USDT, USDC            |
| `ETH`       | ERC20        | USDT, USDC            |
| `BSC`       | BEP20        | USDT, USDC            |
| `POLYGON`   | ERC20        | USDT, USDC            |
| `ARBITRUM`  | ERC20        | USDT, USDC            |
| `AVALANCHE` | ERC20        | USDT, USDC            |

<Note>
  Networks are grouped by address format. TRC20 addresses work only on TRON. ERC20/BEP20 addresses use the same format and work on all EVM-compatible chains (ETH, BSC, Polygon, Arbitrum, Avalanche).
</Note>

## Address Reuse

If you already have an address for the requested address type (TRC20 or ERC20), the existing address is returned instead of generating a new one. The response includes `isNew: false` in this case.

## Example Usage

```javascript theme={null}
const response = await fetch('https://api.fyatu.com/api/v3/account/deposit-address', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    currency: 'USDT',
    network: 'TRON'
  })
});

const { data } = await response.json();

console.log(`Address: ${data.address}`);
console.log(`Type: ${data.addressType}`); // TRC20 or ERC20
console.log(`New address: ${data.isNew}`);
```

<Warning>
  Always verify you're sending on the correct network. Sending crypto on the wrong network may result in permanent loss of funds.
</Warning>

## Compatible Networks

The response includes a `compatibleNetworks` array showing which networks can use this address:

* **TRC20**: Only `["TRON"]`
* **ERC20**: `["ETH", "BSC", "POLYGON", "ARBITRUM", "AVALANCHE"]`


## OpenAPI

````yaml v3/openapi.json POST /account/deposit-address
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths:
  /account/deposit-address:
    post:
      tags:
        - Account
      summary: Generate Deposit Address
      description: >-
        Generate a deposit address for the specified currency and network. If an
        address for that address type (TRC20/ERC20) already exists, returns the
        existing address.
      operationId: generateDepositAddress
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DepositAddressRequest'
            example:
              currency: USDT
              network: TRON
      responses:
        '200':
          description: Deposit address generated or retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DepositAddressResponse'
              example:
                success: true
                status: 200
                message: Deposit address generated successfully
                data:
                  address: TRC20_ADDRESS_HERE
                  addressType: TRC20
                  currency: USDT
                  network: TRON
                  isNew: true
                  generatedAt: '2026-01-05T10:30:00+00:00'
                  compatibleNetworks:
                    - TRON
                meta:
                  requestId: req_abc123def456
                  timestamp: '2026-01-05T10:30:00+00:00'
        '400':
          $ref: '#/components/responses/ValidationError'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - BearerAuth: []
components:
  schemas:
    DepositAddressRequest:
      type: object
      required:
        - currency
        - network
      properties:
        currency:
          type: string
          enum:
            - USDT
            - USDC
          description: Cryptocurrency to deposit
        network:
          type: string
          enum:
            - TRON
            - ETH
            - BSC
            - POLYGON
            - ARBITRUM
            - AVALANCHE
          description: Blockchain network
    DepositAddressResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        status:
          type: integer
          example: 200
        message:
          type: string
        data:
          $ref: '#/components/schemas/DepositAddressData'
        meta:
          $ref: '#/components/schemas/Meta'
    DepositAddressData:
      type: object
      properties:
        address:
          type: string
          description: The deposit wallet address
        addressType:
          type: string
          enum:
            - TRC20
            - ERC20
            - BEP20
          description: Address format type. BEP20 is returned for BSC network.
        currency:
          type: string
          description: Currency for this address
        network:
          type: string
          description: Network for this address
        isNew:
          type: boolean
          description: Whether address was newly generated
        generatedAt:
          type: string
          format: date-time
        compatibleNetworks:
          type: array
          items:
            type: string
          description: Networks compatible with this address
    Meta:
      type: object
      properties:
        requestId:
          type: string
          description: Unique request ID for tracking
          example: req_abc123def456
        timestamp:
          type: string
          format: date-time
          description: ISO 8601 timestamp of the response
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        status:
          type: integer
          example: 401
        message:
          type: string
          example: Invalid credentials
        error:
          $ref: '#/components/schemas/Error'
        meta:
          $ref: '#/components/schemas/Meta'
    Error:
      type: object
      properties:
        code:
          type: string
          description: Error code for programmatic handling
          example: AUTH_INVALID_CREDENTIALS
        details:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
          description: Validation error details (for VALIDATION_ERROR)
    ValidationError:
      type: object
      properties:
        field:
          type: string
          description: Field that failed validation
          example: appId
        message:
          type: string
          description: Validation error message
          example: AppId is required
  responses:
    ValidationError:
      description: Validation failed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 400
            message: Validation failed
            error:
              code: VALIDATION_ERROR
              details:
                - field: currency
                  message: Currency is required
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
    Unauthorized:
      description: Authentication required or token invalid
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 401
            message: Unable to identify business
            error:
              code: AUTH_TOKEN_INVALID
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
    ServerError:
      description: Server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            success: false
            status: 500
            message: Failed to generate deposit address. Please try again later.
            error:
              code: SERVER_ERROR
            meta:
              requestId: req_abc123
              timestamp: '2026-01-05T10:30:00+00:00'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from /auth/token

````