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

# List withdrawal methods

> Returns the withdrawal methods available for the vault. Each entry carries the method identifier, fee and fee asset, minimum withdrawal amount, disabled flag, and the network metadata for the underlying chain. Filter by `asset` and `asset_class` together to limit results to a single asset.

**Rate limit:** 200 requests per 30 seconds per IP.



## OpenAPI

````yaml /openapi/insto-custody-rest.yaml get /v0/insto/custody/vaults/{vault_id}/withdrawal-methods
openapi: 3.0.0
info:
  title: Insto Custody External REST API
  version: 1.0.0
  description: ''
servers:
  - url: https://api.kraken.com
    description: Production Server
security:
  - API-Key: []
    API-Sign: []
tags:
  - name: Custody External API
  - name: apiFormat:kraken2025
paths:
  /v0/insto/custody/vaults/{vault_id}/withdrawal-methods:
    get:
      tags:
        - Custody External API
        - apiFormat:kraken2025
      summary: List withdrawal methods
      description: >-
        Returns the withdrawal methods available for the vault. Each entry
        carries the method identifier, fee and fee asset, minimum withdrawal
        amount, disabled flag, and the network metadata for the underlying
        chain. Filter by `asset` and `asset_class` together to limit results to
        a single asset.


        **Rate limit:** 200 requests per 30 seconds per IP.
      operationId: getV0InstoCustodyVaultsVaultIdWithdrawalMethods
      parameters:
        - in: query
          name: asset
          description: >-
            Filter results to a single asset code (e.g. `BTC`). Requires
            `asset_class` when supplied.
          schema:
            type: string
            example: BTC
          style: form
        - in: query
          name: asset_class
          description: >-
            Asset class filter. Required when `asset` is supplied. Currently
            only `currency` is supported.
          schema:
            type: string
            example: currency
          style: form
        - in: path
          name: vault_id
          required: true
          description: >-
            Vault identifier, a `V`-prefixed 14-char base32 string with a final
            check character.
          schema:
            type: string
            example: VABCDEF234567A
          style: simple
      responses:
        '200':
          description: >-
            Withdrawal methods available for the vault, optionally filtered by
            asset.
          content:
            application/json:
              schema:
                type: array
                description: List of withdrawal methods available for the vault.
                items:
                  type: object
                  description: A single withdrawal method available for the vault.
                  properties:
                    name:
                      type: string
                      description: Funding method name (e.g. `Bitcoin`, `ACH`, `SEPA`).
                      example: Bitcoin
                    method_id:
                      type: string
                      description: Funding method identifier.
                      example: 11111111-1111-1111-1111-111111111111
                    fee:
                      type: string
                      description: Withdrawal fee, fixed-precision decimal as string.
                      example: '0.00010000'
                    fee_asset:
                      type: string
                      description: >-
                        Asset code the fee is charged in. May differ from the
                        asset being withdrawn.
                      example: BTC
                    fee_asset_class:
                      type: string
                      description: >-
                        Asset class of the fee asset. Currently always
                        `currency`.
                      example: currency
                    minimum:
                      type: string
                      description: >-
                        Minimum withdrawal amount, fixed-precision decimal as
                        string.
                      example: '0.00100000'
                    is_disabled:
                      type: boolean
                      description: Whether this method is temporarily disabled.
                      example: false
                    asset:
                      type: string
                      description: Asset code (e.g. `BTC`, `USD`).
                      example: BTC
                    asset_class:
                      type: string
                      description: Asset class. Currently always `currency`.
                      example: currency
                    network_info:
                      type: object
                      description: >-
                        Network metadata for the underlying chain. Omitted for
                        methods without an associated chain.
                      properties:
                        network:
                          type: string
                          description: >-
                            Underlying network or chain name (e.g. `Bitcoin`,
                            `Ethereum`).
                          example: Bitcoin
                        explorer:
                          type: string
                          description: >-
                            Block explorer URL template for the underlying
                            chain.
                          example: https://www.blockchain.com/btc/tx/{tx_id}
        '400':
          description: >-
            Bad Request. The request failed validation. Examples: malformed
            `vault_id`, or `asset` supplied without `asset_class`.
          content:
            application/problem+json:
              schema:
                description: >-
                  Type for errors when using the Kraken2025 format.


                  This format follows `Problem Details for HTTP APIs`
                  ([rfc7807]).


                  [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                type: object
                properties:
                  type:
                    description: >-
                      URL uniquely identifying the error type relative to an
                      operation
                    type: string
                    enum:
                      - tag:kraken.com,2025:BadRequest
                    example: tag:kraken.com,2025:BadRequest
                  status:
                    description: HTTP status (provided for convenience)
                    type: integer
                    format: uint16
                    minimum: 0
                    example: 400
                  title:
                    description: Short human-readable summary
                    type: string
                    example: Bad Request
                  detail:
                    nullable: true
                    description: Help to solve the problem
                    type: string
                    example: asset supplied without asset_class
                  instance:
                    nullable: true
                    description: Link to debug data for this particular error
                    type: string
                    example: https://debug.kraken.com/req/01HXYZABCDEF
                  data:
                    description: Error-specific payload.
                    type: object
                    properties:
                      message:
                        description: Human-readable description of the validation failure.
                        type: string
                        example: asset_class is required when asset is supplied
                    required:
                      - message
                required:
                  - data
                  - status
                  - title
                  - type
        '403':
          description: Forbidden. The caller lacks access to the requested vault.
          content:
            application/problem+json:
              schema:
                description: >-
                  Type for errors when using the Kraken2025 format.


                  This format follows `Problem Details for HTTP APIs`
                  ([rfc7807]).


                  [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                type: object
                properties:
                  type:
                    description: >-
                      URL uniquely identifying the error type relative to an
                      operation
                    type: string
                    enum:
                      - tag:kraken.com,2025:PermissionDenied
                    example: tag:kraken.com,2025:PermissionDenied
                  status:
                    description: HTTP status (provided for convenience)
                    type: integer
                    format: uint16
                    minimum: 0
                    example: 403
                  title:
                    description: Short human-readable summary
                    type: string
                    example: Permission Denied
                  detail:
                    nullable: true
                    description: Help to solve the problem
                    type: string
                    example: The caller does not have access to the requested vault.
                  instance:
                    nullable: true
                    description: Link to debug data for this particular error
                    type: string
                    example: https://debug.kraken.com/req/01HXYZABCDEF
                  data:
                    description: Error-specific payload.
                    type: object
                    properties:
                      message:
                        description: Human-readable description of why access was denied.
                        type: string
                        example: Caller lacks read access to vault VABCDEF234567A
                    required:
                      - message
                required:
                  - data
                  - status
                  - title
                  - type
        '404':
          description: Not Found. No asset matched the supplied `asset` and `asset_class`.
          content:
            application/problem+json:
              schema:
                description: >-
                  Type for errors when using the Kraken2025 format.


                  This format follows `Problem Details for HTTP APIs`
                  ([rfc7807]).


                  [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                type: object
                properties:
                  type:
                    description: >-
                      URL uniquely identifying the error type relative to an
                      operation
                    type: string
                    enum:
                      - tag:kraken.com,2025:AssetNotFound
                    example: tag:kraken.com,2025:AssetNotFound
                  status:
                    description: HTTP status (provided for convenience)
                    type: integer
                    format: uint16
                    minimum: 0
                    example: 404
                  title:
                    description: Short human-readable summary
                    type: string
                    example: Asset Not Found
                  detail:
                    nullable: true
                    description: Help to solve the problem
                    type: string
                    example: No asset matched the supplied asset and asset_class.
                  instance:
                    nullable: true
                    description: Link to debug data for this particular error
                    type: string
                    example: https://debug.kraken.com/req/01HXYZABCDEF
                  data:
                    description: Error-specific payload.
                    type: object
                    properties:
                      message:
                        description: Human-readable description of the lookup failure.
                        type: string
                        example: Asset BTC with class currency was not found
                    required:
                      - message
                required:
                  - data
                  - status
                  - title
                  - type
        '500':
          description: >-
            Internal Server Error. An unhandled exception occurred while serving
            the request.
          content:
            application/problem+json:
              schema:
                oneOf:
                  - description: >-
                      Type for errors when using the Kraken2025 format.


                      This format follows `Problem Details for HTTP APIs`
                      ([rfc7807]).


                      [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                    type: object
                    properties:
                      type:
                        description: >-
                          URL uniquely identifying the error type relative to an
                          operation
                        type: string
                        enum:
                          - tag:kraken.com,2025:gateway/ReadUpstream
                        example: tag:kraken.com,2025:gateway/ReadUpstream
                      status:
                        description: HTTP status (provided for convenience)
                        type: integer
                        format: uint16
                        minimum: 0
                        example: 500
                      title:
                        description: Short human-readable summary
                        type: string
                        example: Internal Server Error
                      detail:
                        nullable: true
                        description: Help to solve the problem
                        type: string
                        example: Failed to read response from upstream custody service.
                      instance:
                        nullable: true
                        description: Link to debug data for this particular error
                        type: string
                        example: https://debug.kraken.com/req/01HXYZABCDEF
                      data:
                        description: Custom data attached to this problem
                    required:
                      - data
                      - status
                      - title
                      - type
                  - description: >-
                      Type for errors when using the Kraken2025 format.


                      This format follows `Problem Details for HTTP APIs`
                      ([rfc7807]).


                      [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                    type: object
                    properties:
                      type:
                        description: >-
                          URL uniquely identifying the error type relative to an
                          operation
                        type: string
                        enum:
                          - tag:kraken.com,2025:gateway/WriteResponse
                        example: tag:kraken.com,2025:gateway/WriteResponse
                      status:
                        description: HTTP status (provided for convenience)
                        type: integer
                        format: uint16
                        minimum: 0
                        example: 500
                      title:
                        description: Short human-readable summary
                        type: string
                        example: Internal Server Error
                      detail:
                        nullable: true
                        description: Help to solve the problem
                        type: string
                        example: Failed to write response to upstream custody service.
                      instance:
                        nullable: true
                        description: Link to debug data for this particular error
                        type: string
                        example: https://debug.kraken.com/req/01HXYZABCDEF
                      data:
                        description: Custom data attached to this problem
                    required:
                      - data
                      - status
                      - title
                      - type
                  - description: >-
                      Type for errors when using the Kraken2025 format.


                      This format follows `Problem Details for HTTP APIs`
                      ([rfc7807]).


                      [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                    type: object
                    properties:
                      type:
                        description: >-
                          URL uniquely identifying the error type relative to an
                          operation
                        type: string
                        enum:
                          - tag:kraken.com,2025:gateway/Connect
                        example: tag:kraken.com,2025:gateway/Connect
                      status:
                        description: HTTP status (provided for convenience)
                        type: integer
                        format: uint16
                        minimum: 0
                        example: 500
                      title:
                        description: Short human-readable summary
                        type: string
                        example: Internal Server Error
                      detail:
                        nullable: true
                        description: Help to solve the problem
                        type: string
                        example: Failed to connect to upstream custody service.
                      instance:
                        nullable: true
                        description: Link to debug data for this particular error
                        type: string
                        example: https://debug.kraken.com/req/01HXYZABCDEF
                      data:
                        description: Custom data attached to this problem
                    required:
                      - data
                      - status
                      - title
                      - type
                  - description: >-
                      Type for errors when using the Kraken2025 format.


                      This format follows `Problem Details for HTTP APIs`
                      ([rfc7807]).


                      [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                    type: object
                    properties:
                      type:
                        description: >-
                          URL uniquely identifying the error type relative to an
                          operation
                        type: string
                        enum:
                          - tag:kraken.com,2025:gateway/Fatal
                        example: tag:kraken.com,2025:gateway/Fatal
                      status:
                        description: HTTP status (provided for convenience)
                        type: integer
                        format: uint16
                        minimum: 0
                        example: 500
                      title:
                        description: Short human-readable summary
                        type: string
                        example: Internal Server Error
                      detail:
                        nullable: true
                        description: Help to solve the problem
                        type: string
                        example: >-
                          A fatal gateway error occurred while serving the
                          request.
                      instance:
                        nullable: true
                        description: Link to debug data for this particular error
                        type: string
                        example: https://debug.kraken.com/req/01HXYZABCDEF
                      data:
                        description: Custom data attached to this problem
                    required:
                      - data
                      - status
                      - title
                      - type
                  - description: >-
                      Type for errors when using the Kraken2025 format.


                      This format follows `Problem Details for HTTP APIs`
                      ([rfc7807]).


                      [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                    type: object
                    properties:
                      type:
                        description: >-
                          URL uniquely identifying the error type relative to an
                          operation
                        type: string
                        enum:
                          - tag:kraken.com,2025:Unknown
                        example: tag:kraken.com,2025:Unknown
                      status:
                        description: HTTP status (provided for convenience)
                        type: integer
                        format: uint16
                        minimum: 0
                        example: 500
                      title:
                        description: Short human-readable summary
                        type: string
                        example: Internal Server Error
                      detail:
                        nullable: true
                        description: Help to solve the problem
                        type: string
                        example: >-
                          An unexpected error occurred while serving the
                          request.
                      instance:
                        nullable: true
                        description: Link to debug data for this particular error
                        type: string
                        example: https://debug.kraken.com/req/01HXYZABCDEF
                      data:
                        type: object
                        properties:
                          message:
                            type: string
                            description: >-
                              Human-readable description of the underlying
                              failure.
                            example: Unhandled exception while servicing the request.
                          core_error:
                            type: string
                            description: Identifier for the originating error.
                            example: InternalError
                        required:
                          - message
                          - core_error
                        description: >-
                          Error-specific payload returned for an unhandled
                          exception.
                    required:
                      - data
                      - status
                      - title
                      - type
        '503':
          description: >-
            Service Unavailable. The upstream custody service could not be
            reached.
          content:
            application/problem+json:
              schema:
                description: >-
                  Type for errors when using the Kraken2025 format.


                  This format follows `Problem Details for HTTP APIs`
                  ([rfc7807]).


                  [rfc7807]: https://datatracker.ietf.org/doc/html/rfc7807
                type: object
                properties:
                  type:
                    description: >-
                      URL uniquely identifying the error type relative to an
                      operation
                    type: string
                    enum:
                      - tag:kraken.com,2025:gateway/Connect
                    example: tag:kraken.com,2025:gateway/Connect
                  status:
                    description: HTTP status (provided for convenience)
                    type: integer
                    format: uint16
                    minimum: 0
                    example: 503
                  title:
                    description: Short human-readable summary
                    type: string
                    example: Service Unavailable
                  detail:
                    nullable: true
                    description: Help to solve the problem
                    type: string
                    example: >-
                      Downstream custody service is temporarily unreachable;
                      retry with backoff.
                  instance:
                    nullable: true
                    description: Link to debug data for this particular error
                    type: string
                    example: https://debug.kraken.com/req/01HXYZABCDEF
                  data:
                    description: Custom data attached to this problem
                required:
                  - data
                  - status
                  - title
                  - type
      security:
        - API Key Auth (key): []
          API Key Auth (signature): []
          API Key Auth (nonce): []
          API Key Auth (otp): []
components:
  securitySchemes:
    API Key Auth (key):
      type: apiKey
      in: header
      name: api-key
    API Key Auth (signature):
      type: apiKey
      in: header
      name: api-sign
    API Key Auth (nonce):
      type: apiKey
      in: header
      name: api-nonce
    API Key Auth (otp):
      type: apiKey
      in: header
      name: api-otp

````