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

# Read own deposit address

> Funding service validates exact catalog network/asset and verified wallet ownership. Address, memo, QR payload and minimum come from that service; no EVM network inference or address generation. Requires explicit account.read. API-key owner only; cookies and caller-supplied user IDs confer no access. Unknown balances/prices remain null with reasons and original watermarks. No signing authority.



## OpenAPI

````yaml https://www.oceanx.trade/api/v1/openapi.json get /api/v1/account/deposit-address
openapi: 3.1.0
info:
  title: OceanX Developer API
  version: 1.0.0
  description: >-
    OceanX Developer API v1 (beta). Covers every public route and method: market
    data, charts, token/risk facts, wallet analytics, tracker, copy reads,
    alerts, owned account wallet/funding reads, spot quotes and perps. Scope and
    availability are operation-specific. Spot execution, copy execution, account
    withdrawals, developer webhooks and prediction trading are not public v1
    capabilities. Perps order submission and collateral rebalance remain
    unavailable; their error contracts are explicit. Documentation:
    https://docs.oceanx.trade/api/overview.
  contact:
    url: https://docs.oceanx.trade
  termsOfService: https://www.oceanx.trade/legal/terms
  license:
    name: Proprietary
    url: https://www.oceanx.trade/legal/terms
servers:
  - url: https://www.oceanx.trade
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Perps
    description: Cross-venue market data and explicit account-wallet execution limitations.
  - name: Router
    description: >-
      Read-only Raptor route quotes and public Solana transaction status. Build
      and execution remain separately gated.
  - name: Market Data
    description: Read-only OceanX market context sourced and cached by VM producers.
  - name: Spot
    description: >-
      Executable Solana swap quotes off OceanX's own router, and the exit
      checker that reports whether a whole position can be sold.
  - name: Callouts
    description: >-
      Public token callouts — user-posted token calls with live click/volume
      attribution stats. Read-only.
  - name: Copy Trading
    description: Key-owner follow, fill and PnL reads; no execution authority.
  - name: Price Alerts
    description: Key-owner alert management through the existing evaluator; no webhooks.
paths:
  /api/v1/account/deposit-address:
    get:
      tags:
        - Account
      summary: Read own deposit address
      description: >-
        Funding service validates exact catalog network/asset and verified
        wallet ownership. Address, memo, QR payload and minimum come from that
        service; no EVM network inference or address generation. Requires
        explicit account.read. API-key owner only; cookies and caller-supplied
        user IDs confer no access. Unknown balances/prices remain null with
        reasons and original watermarks. No signing authority.
      operationId: getAccountDepositAddress
      parameters:
        - name: wallet
          in: query
          required: true
          schema:
            type: string
            maxLength: 128
            description: >-
              Owned registry wallet_id returned by account/wallets; never an
              arbitrary address.
        - name: network
          in: query
          required: true
          schema:
            type: string
            maxLength: 128
            description: >-
              Exact funding catalog network ID, e.g. eip155:1. Wallet family
              ethereum is not network admission.
        - name: asset
          in: query
          required: true
          schema:
            type: string
            maxLength: 256
      responses:
        '200':
          description: >-
            Owner-scoped read. Cache-Control: no-store. Rate-limit headers are
            included.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/AccountDepositAddress'
                  nextCursor:
                    type:
                      - string
                      - 'null'
                  meta:
                    type: object
                    required:
                      - requestId
                      - executionAuthority
                    properties:
                      requestId:
                        type: string
                        format: uuid
                      executionAuthority:
                        const: none
                      partial:
                        type: array
                        items:
                          type: object
                          properties:
                            chain:
                              type: string
                            reason:
                              type: string
                          required:
                            - chain
                            - reason
                          additionalProperties: false
                      asOf:
                        type: integer
                        minimum: 0
                        maximum: 9007199254740991
                      source:
                        const: native-indexer
                required:
                  - data
                  - meta
                additionalProperties: false
        '400':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
        '401':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
        '403':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
        '404':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
        '429':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
        '503':
          description: Public API error; requestId identifies this request.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                    additionalProperties: false
                  requestId:
                    type: string
                    format: uuid
                required:
                  - error
                  - requestId
                additionalProperties: false
      security:
        - bearerAuth: []
components:
  schemas:
    AccountDepositAddress:
      type: object
      properties:
        ownedWallet:
          type: object
          properties:
            walletId:
              type: string
            family:
              enum:
                - solana
                - evm
            address:
              type: string
          required:
            - walletId
            - family
            - address
          additionalProperties: false
        network:
          type: object
          properties:
            id:
              type: string
            name:
              type: string
            family:
              enum:
                - solana
                - evm
            memoRequired:
              type: boolean
          required:
            - id
            - name
            - family
            - memoRequired
          additionalProperties: false
        asset:
          type: object
          properties:
            id:
              type: string
            network:
              type: string
            address:
              type: string
            symbol:
              type: string
            decimals:
              type: integer
              minimum: 0
              maximum: 36
            native:
              type: boolean
          required:
            - id
            - network
            - address
            - symbol
            - decimals
            - native
          additionalProperties: false
        address:
          type: string
        qrPayload:
          type: string
        memoRequired:
          type: boolean
        memo:
          type:
            - string
            - 'null'
        minimumAtomic:
          type:
            - string
            - 'null'
          pattern: ^(0|[1-9]\d*)$
          maxLength: 128
        mismatchWarning:
          type: string
        asOf:
          type: integer
          minimum: 0
          maximum: 9007199254740991
      required:
        - ownedWallet
        - network
        - asset
        - address
        - qrPayload
        - memoRequired
        - memo
        - minimumAtomic
        - mismatchWarning
        - asOf
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OceanX API key, created in the app under Settings → Developer API.
        Send it as `Authorization: Bearer ox_live_…`. Required scopes are
        operation-specific: market reads use md.read, tracker uses tracker.read,
        copy reads use copy.read, alert operations use alerts.read or
        alerts.write, and owned wallet/funding reads require explicit
        account.read. New scopes require explicit selection and grant no trading
        authority. Existing perps operations retain their documented scopes.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.