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

# Get Ark server info

> Returns the Ark server's configuration parameters, including network, public key, round interval, VTXO expiry and exit deltas, fee settings, and Lightning support details.



## OpenAPI

````yaml https://gitlab.com/ark-bitcoin/bark/-/raw/master/bark-rest/openapi.json get /api/v1/wallet/ark-info
openapi: 3.1.0
info:
  title: barkd REST API
  description: >-
    A simple REST API for barkd, a wallet daemon for integrating bitcoin
    payments into your app over HTTP. Supports self-custodial Lightning, Ark,
    and on-chain out of the box.


    barkd is a long-running daemon best suited for always-on or
    high-connectivity environments like nodes, servers, desktops, and
    point-of-sale terminals.


    All endpoints return JSON. Amounts are denominated in satoshis.
  contact:
    name: Second Team
    email: hello@second.tech
  license:
    name: MIT
    identifier: MIT
  version: 0.1.4
servers: []
security:
  - bearer: []
tags:
  - name: boards
    description: Move on-chain bitcoin onto the Ark protocol.
  - name: exits
    description: Move bitcoin back on-chain without server cooperation.
  - name: fees
    description: Estimate fees for wallet operations before executing them.
  - name: lightning
    description: Create Lightning invoices and track receives.
  - name: onchain
    description: Manage barkd's on-chain bitcoin wallet.
  - name: wallet
    description: Manage Ark balances and VTXOs, send payments via Ark, LN, and on-chain.
  - name: bitcoin
    description: Query bitcoin network data.
  - name: notifications
    description: Receive real-time notifications from barkd.
paths:
  /api/v1/wallet/ark-info:
    get:
      tags:
        - wallet
      summary: Get Ark server info
      description: >-
        Returns the Ark server's configuration parameters, including network,
        public key, round interval, VTXO expiry and exit deltas, fee settings,
        and Lightning support details.
      operationId: ark_info
      responses:
        '200':
          description: Returns the Ark info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArkInfo'
        '404':
          description: Wallet not connected to an Ark server
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerError'
components:
  schemas:
    ArkInfo:
      type: object
      required:
        - network
        - server_pubkey
        - mailbox_pubkey
        - round_interval
        - nb_round_nonces
        - vtxo_exit_delta
        - vtxo_expiry_delta
        - htlc_send_expiry_delta
        - htlc_expiry_delta
        - max_vtxo_amount
        - required_board_confirmations
        - max_user_invoice_cltv_delta
        - min_board_amount_sat
        - offboard_feerate_sat_per_kvb
        - ln_receive_anti_dos_required
        - fees
        - max_vtxo_exit_depth
      properties:
        fees:
          $ref: '#/components/schemas/FeeSchedule'
          description: >-
            The fee schedule outlining any fees that must be paid to interact
            with the Ark server.
        htlc_expiry_delta:
          $ref: '#/components/schemas/u16'
          description: >-
            The number of blocks to keep between Lightning and Ark HTLCs
            expiries
        htlc_send_expiry_delta:
          $ref: '#/components/schemas/u16'
          description: >-
            The number of blocks after which an HTLC-send VTXO expires once
            granted.
        ln_receive_anti_dos_required:
          type: boolean
          description: |-
            Indicates whether the Ark server requires clients to either
            provide a VTXO ownership proof, or a lightning receive token
            when preparing a lightning claim.
        mailbox_pubkey:
          type: string
          description: The pubkey used for blinding unified mailbox IDs
        max_user_invoice_cltv_delta:
          type: integer
          format: int32
          description: |-
            Maximum CLTV delta server will allow clients to request an
            invoice generation with.
          minimum: 0
        max_vtxo_amount:
          type: integer
          format: int64
          description: Maximum amount of a VTXO
          minimum: 0
        max_vtxo_exit_depth:
          type: integer
          format: int32
          description: >-
            Maximum exit depth (genesis chain length) allowed for a VTXO.

            Once a VTXO's exit depth reaches this value the server will refuse
            to

            cosign further OOR transactions spending it. Clients should refresh

            their VTXOs into a round before this limit is reached.
          minimum: 0
        min_board_amount_sat:
          type: integer
          format: int64
          description: Minimum amount for a board the server will cosign
          minimum: 0
        nb_round_nonces:
          type: integer
          description: Number of nonces per round
          minimum: 0
        network:
          type: string
          description: The bitcoin network the server operates on
        offboard_feerate_sat_per_kvb:
          type: integer
          format: int64
          description: offboard feerate in sat per kvb
          minimum: 0
        required_board_confirmations:
          type: integer
          description: The number of confirmations required to register a board vtxo
          minimum: 0
        round_interval:
          type: string
          description: The interval between each round
        server_pubkey:
          type: string
          description: The Ark server pubkey
        vtxo_exit_delta:
          $ref: '#/components/schemas/u16'
          description: Delta between exit confirmation and coins becoming spendable
        vtxo_expiry_delta:
          $ref: '#/components/schemas/u16'
          description: Expiration delta of the VTXO
    NotFoundError:
      type: object
      required:
        - resources
        - message
      properties:
        message:
          type: string
        resources:
          type: array
          items:
            type: string
    InternalServerError:
      type: object
      required:
        - message
      properties:
        message:
          type: string
    FeeSchedule:
      type: object
      description: Complete fee schedule for all operations.
      required:
        - board
        - offboard
        - refresh
        - lightning_receive
        - lightning_send
      properties:
        board:
          $ref: '#/components/schemas/BoardFees'
        lightning_receive:
          $ref: '#/components/schemas/LightningReceiveFees'
        lightning_send:
          $ref: '#/components/schemas/LightningSendFees'
        offboard:
          $ref: '#/components/schemas/OffboardFees'
        refresh:
          $ref: '#/components/schemas/RefreshFees'
    u16:
      type: integer
      format: int32
      minimum: 0
    BoardFees:
      type: object
      description: Fees for boarding the ark.
      required:
        - min_fee_sat
        - base_fee_sat
        - ppm
      properties:
        base_fee_sat:
          type: integer
          format: int64
          description: A fee applied to every transaction regardless of value.
          minimum: 0
        min_fee_sat:
          type: integer
          format: int64
          description: Minimum fee to charge.
          minimum: 0
        ppm:
          type: integer
          format: int64
          description: >-
            PPM (parts per million) fee rate to apply based on the value of the
            transaction.
          minimum: 0
    LightningReceiveFees:
      type: object
      description: Fees for lightning receive operations.
      required:
        - base_fee_sat
        - ppm
      properties:
        base_fee_sat:
          type: integer
          format: int64
          description: A fee applied to every transaction regardless of value.
          minimum: 0
        ppm:
          type: integer
          format: int64
          description: >-
            PPM (parts per million) fee rate to apply based on the value of the
            transaction.
          minimum: 0
    LightningSendFees:
      type: object
      description: Fees for lightning send operations.
      required:
        - min_fee_sat
        - base_fee_sat
        - ppm_expiry_table
      properties:
        base_fee_sat:
          type: integer
          format: int64
          description: A fee applied to every transaction regardless of value.
          minimum: 0
        min_fee_sat:
          type: integer
          format: int64
          description: Minimum fee to charge.
          minimum: 0
        ppm_expiry_table:
          type: array
          items:
            $ref: '#/components/schemas/PpmExpiryFeeEntry'
          description: >-
            A table mapping how soon a VTXO will expire to a PPM (parts per
            million) fee rate.

            The table should be sorted by each `expiry_blocks_threshold` value
            in ascending order.
    OffboardFees:
      type: object
      description: Fees for offboarding from the ark.
      required:
        - base_fee_sat
        - fixed_additional_vb
        - ppm_expiry_table
      properties:
        base_fee_sat:
          type: integer
          format: int64
          description: A fee applied to every transaction regardless of value.
          minimum: 0
        fixed_additional_vb:
          type: integer
          format: int64
          description: >-
            Fixed number of virtual bytes charged offboard on top of the output
            size


            The fee for an offboard will be this value, plus the offboard output
            virtual size,

            multiplied with the offboard fee rate, plus the `base_fee`, and plus
            the additional fee

            calculated with the `ppm_expiry_table`.
          minimum: 0
        ppm_expiry_table:
          type: array
          items:
            $ref: '#/components/schemas/PpmExpiryFeeEntry'
          description: >-
            A table mapping how soon a VTXO will expire to a PPM (parts per
            million) fee rate.

            The table should be sorted by each `expiry_blocks_threshold` value
            in ascending order.
    RefreshFees:
      type: object
      description: Fees for refresh operations.
      required:
        - base_fee_sat
        - ppm_expiry_table
      properties:
        base_fee_sat:
          type: integer
          format: int64
          description: A fee applied to every transaction regardless of value.
          minimum: 0
        ppm_expiry_table:
          type: array
          items:
            $ref: '#/components/schemas/PpmExpiryFeeEntry'
          description: >-
            A table mapping how soon a VTXO will expire to a PPM (parts per
            million) fee rate.

            The table should be sorted by each `expiry_blocks_threshold` value
            in ascending order.
    PpmExpiryFeeEntry:
      type: object
      description: >-
        Entry in a table to calculate the PPM (parts per million) fee rate of a
        transaction based on how

        new a VTXO is.
      required:
        - expiry_blocks_threshold
        - ppm
      properties:
        expiry_blocks_threshold:
          type: integer
          format: int32
          description: >-
            A threshold for the number of blocks until a VTXO expires for the
            `ppm` amount to apply.

            As an example, if this value is set to 50 and a VTXO expires in 60
            blocks, this

            [PpmExpiryFeeEntry] will be used to calculate the fee unless another
            entry exists with an

            `expiry_blocks_threshold` with a value between 51 and 60
            (inclusive).
          minimum: 0
        ppm:
          type: integer
          format: int64
          description: PPM (parts per million) fee rate to apply for this expiry period.
          minimum: 0
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: AuthToken
      description: Base64url-encoded auth token

````