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

# Aggregated counts and volumes over the last N days



## OpenAPI

````yaml /openapi.json get /v1/transactions/summary
openapi: 3.1.0
info:
  title: KryptaPay API
  description: >-
    API B2B de paiements numériques pour l'Afrique francophone.


    ## Authentification

    Deux méthodes sont supportées :

    - **Session utilisateur** : JWT signé dans un cookie `kp_token` (HttpOnly,
    SameSite=Lax) — utilisé par le tableau de bord.

    - **Clé API** : header `Authorization: Bearer kp_<env>_xxx` — utilisé par
    les intégrations serveur.


    Les endpoints sensibles exigent l'une ou l'autre. Les écritures monétaires
    acceptent un header `Idempotency-Key` pour la dé-duplication.


    ## Enveloppe de réponse

    Toutes les réponses suivent le format `{ ok: boolean, data?: T, error?: {
    code, message, details? } }`.


    ## Webhooks sortants

    Signature HMAC SHA-256 dans le header `X-KryptaPay-Signature`. Le secret est
    défini à la création de l'endpoint.
  version: 1.0.0
  contact:
    name: KryptaPay Support
    email: support@kryptapay.test
    url: https://kryptapay.test
  license:
    name: Proprietary
servers:
  - url: http://localhost
    description: Local dev
security:
  - bearerAuth: []
  - cookieAuth: []
tags:
  - name: wallets
    description: Portefeuilles fiat / stablecoin / IBAN virtuels
  - name: transactions
    description: Historique unifié des mouvements
  - name: payouts
    description: Versements Mobile Money / banque / stablecoin
  - name: payins
    description: Encaissements et liens de paiement
  - name: fx
    description: Cotations et conversions multi-devises
  - name: counterparties
    description: Bénéficiaires et tiers
  - name: invoices
    description: Factures + paiement public + reçus
  - name: status
    description: Statut public des services
paths:
  /v1/transactions/summary:
    get:
      tags:
        - transactions
      summary: Aggregated counts and volumes over the last N days
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 365
            default: 30
          in: query
          name: days
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      rangeDays:
                        type: integer
                      since:
                        type: string
                      byCurrency:
                        type: array
                        items:
                          type: object
                          properties:
                            currency:
                              type: string
                            type:
                              type: string
                            count:
                              type: integer
                            volume:
                              type: string
                            feeTotal:
                              type: string
                          required:
                            - currency
                            - type
                            - count
                            - volume
                            - feeTotal
                          additionalProperties: false
                      totals:
                        type: object
                        properties:
                          count:
                            type: integer
                          pending:
                            type: integer
                          failed:
                            type: integer
                          completed:
                            type: integer
                        required:
                          - count
                          - pending
                          - failed
                          - completed
                        additionalProperties: false
                      recent:
                        type: array
                    required:
                      - rangeDays
                      - since
                      - byCurrency
                      - totals
                      - recent
                    additionalProperties: false
                required:
                  - ok
                  - data
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT utilisateur ou clé API `kp_<env>_xxx`
    cookieAuth:
      type: apiKey
      in: cookie
      name: kp_token
      description: Session signée (front Next.js)

````