For AI agents: the complete documentation index is available at /es/llms.txt, the full documentation bundle is available at /es/llms-full.txt, and this page is available as Markdown at /es/api/account-balance/get-balance.md.
  • Español
  • Obtener saldo por activo

    Generado a partir de la especificación OpenAPI de Finity.

    URL basehttps://api2.finity.com.co

    Saldo de cuenta

    GET/v0/account/{asset}

    Get account balance by asset

    Retrieves the current balance for a specific asset (USD or COP) for the authenticated user.

    Requiere token Bearer

    Solicitud

    NombreUbicaciónTipoRequeridoEjemplo
    assetAsset type for balance querypathUSD | COPUSD

    Respuestas

    200The balance has been successfully retrieved.
    asset: USD | COP
    balance: string
    lastUpdated: string
    400Bad request. The asset parameter is invalid.
    statusCode: integer
    message: string
    error: string
    404Balance not found for the specified asset.
    statusCode: integer
    message: string
    error: string

    Probar en vivo

    Live request

    Try this endpoint

    Configure the request and send it directly to the Finity API.

    GET
    Code language

    Authentication

    Use a Bearer token to authorize this request.

    Optional

    Parameters

    Provide the values required by this endpoint.

    Request URLProduction
    GEThttps://api2.finity.com.co/v0/account/{asset}
    Generated Shell requestReady to copy
    curl -X GET \
      'https://api2.finity.com.co/v0/account/{asset}' \
      -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
      -H 'Content-Type: application/json'