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

# Obtener posiciones

> Borrador: especificación en curso. Los endpoints y campos pueden cambiar.

Caja consolidada, saldo en rendimiento, saldo disponible y distribución por activo.
Scope: `read`.


> [!WARNING]
>
> Borrador: especificación en curso. Los endpoints y campos pueden cambiar.


## OpenAPI

````yaml /es/api/openapi.yaml get /posicoes
openapi: 3.1.0
info:
  title: TESA API
  version: 0.2.0-rascunho
  description: >
    **Borrador: especificación en curso. Los endpoints y campos pueden
    cambiar.**


    API del software de tesorería B2B de TESA. El USDC ingresa mediante CCTP de
    Circle

    (Ethereum y Solana) y se asigna a los Treasuries tokenizados (USDY y BUIDL)

    que define la política de la empresa. TESA no recomienda asignaciones, no
    administra

    portafolios ni ejecuta órdenes en nombre de la empresa: el software prepara
    las

    transacciones y la empresa las aprueba y las firma.

    La API es no custodial: nunca recibe una clave privada ni una transacción
    firmada.

    Devuelve transacciones sin firmar y solicitudes de aprobación, y quien firma
    es la

    empresa o su custodio.


    Las rutas de los recursos, los nombres de los campos, los nombres de los
    eventos y los

    códigos de error están en portugués por diseño. Los montos son cadenas
    decimales de USDC

    con dos decimales, las fechas están en ISO 8601 UTC y las listas usan
    paginación por

    cursor (`limite` y `apos`). Todos los valores de ejemplo son ilustrativos.
  contact:
    name: TESA
    email: contact@t3sa.com
    url: https://t3sa.com
servers:
  - url: https://api.t3sa.com/v1
    description: Producción (URL propuesta, aún no disponible)
  - url: https://sandbox.api.t3sa.com/v1
    description: Sandbox (URL propuesta, aún no disponible)
security:
  - bearerAuth: []
tags:
  - name: Organización
    description: La empresa cliente, titular de todas las claves y recursos.
  - name: Carteras
    description: >-
      Billeteras de la empresa vinculadas por dirección pública. Ninguna clave
      pasa por la API.
  - name: Posiciones
    description: Una instantánea de la posición de caja, igual a la del panel.
  - name: Política de asignación
    description: >-
      Activos, proporciones y reglas de rebalanceo definidos y aprobados por la
      empresa. TESA no recomienda asignaciones.
  - name: Propuestas
    description: >-
      Transacciones que el software prepara cuando se cumple una regla de la
      política de la empresa, o por solicitud de la propia empresa. Solo se
      ejecutan con la aprobación y la firma de la empresa.
  - name: Rescates
    description: Devolución de saldo en USDC a una billetera vinculada de la empresa.
  - name: Registros
    description: Pista de auditoría on-chain, con el hash de cada transacción.
  - name: Rendimiento y uso
    description: >-
      Rendimiento calculado por período, solo informativo, y facturas de uso de
      la API. No se cobra nada sobre saldo, rendimiento ni capital principal.
  - name: Webhooks
    description: Destinos que reciben los eventos de TESA.
paths:
  /posicoes:
    get:
      tags:
        - Posiciones
      summary: Obtener posiciones
      description: >
        Borrador: especificación en curso. Los endpoints y campos pueden
        cambiar.


        Caja consolidada, saldo en rendimiento, saldo disponible y distribución
        por activo.

        Scope: `read`.
      operationId: obterPosicoes
      responses:
        '200':
          description: Posiciones actuales.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Posicoes'
        '401':
          $ref: '#/components/responses/NaoAutenticado'
        '429':
          $ref: '#/components/responses/LimiteExcedido'
components:
  schemas:
    Posicoes:
      type: object
      properties:
        total:
          $ref: '#/components/schemas/Valor'
        rendendo:
          $ref: '#/components/schemas/Valor'
        disponivel:
          $ref: '#/components/schemas/Valor'
        por_ativo:
          type: array
          items:
            $ref: '#/components/schemas/AtivoValor'
        yield_acumulado:
          $ref: '#/components/schemas/Valor'
        atualizado_em:
          type: string
          format: date-time
      example:
        total: '1284530.00'
        rendendo: '842110.00'
        disponivel: '442420.00'
        por_ativo:
          - ativo: USDY
            valor: '505266.00'
            percentual: 60
          - ativo: BUIDL
            valor: '336844.00'
            percentual: 40
        yield_acumulado: '18432.55'
        atualizado_em: '2026-09-01T12:00:00Z'
    Valor:
      type: string
      pattern: ^\d+\.\d{2}$
      description: Monto en USDC, una cadena decimal con dos decimales.
      examples:
        - '842110.00'
    AtivoValor:
      type: object
      properties:
        ativo:
          $ref: '#/components/schemas/Ativo'
        valor:
          $ref: '#/components/schemas/Valor'
        percentual:
          type: number
          examples:
            - 60
    Erro:
      type: object
      properties:
        erro:
          type: object
          properties:
            codigo:
              type: string
              examples:
                - saldo_insuficiente
            mensagem:
              type: string
            campo:
              type:
                - string
                - 'null'
            requisicao_id:
              type: string
              examples:
                - req_9d8c7b
    Ativo:
      type: string
      enum:
        - USDY
        - BUIDL
  responses:
    NaoAutenticado:
      description: Clave ausente, inválida o revocada, o firma HMAC inválida.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
    LimiteExcedido:
      description: Límite de solicitudes alcanzado. Respetar el encabezado `Retry-After`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Erro'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        La clave de API de la organización (`tesa_live_...` en producción,
        `tesa_test_...` en el sandbox).

````

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