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

# Sello de tiempo de un documento

> Devuelve la prueba OpenTimestamps de un documento que selló este servicio, o su estado. No requiere clave de
API.

- Con `.ots` al final del nombre, devuelve el archivo de la prueba como adjunto
 (`application/vnd.opentimestamps.v1`), con el header `X-OTS-Status`: `pending` o `complete`.
- Sin `.ots`, devuelve el estado en JSON: `digest`, `status`, los bloques de Bitcoin que anclan la prueba con su
 `merkle_root`, los calendarios, las fechas de pedido y de confirmación, el enlace de descarga, qué prueba y qué
 no, y los pasos para verificarla.

Una prueba pendiente se intenta completar al consultarla, como máximo una vez cada 10 minutos por documento.
Una prueba completa se puede guardar en caché 1 día.

Errores: un nombre que no es un sha256 en hexadecimal responde `400`; un documento que este servicio no selló
responde `404`.



## OpenAPI

````yaml /openapi.es.json get /v1/evidence/timestamp/{name}
openapi: 3.1.0
info:
  title: API de blockgence
  description: >-
    La API de **blockgence** da acceso al rastreo de fondos, la atribución de
    entidades y el screening de riesgo

    explicable sobre varias redes, con la evidencia de cada resultado.


    ### Autenticación

    Todas las rutas `/v1/*` requieren una **clave de API**, en el header
    `X-API-Key: <clave>` o en

    `Authorization: Bearer <clave>`. La clave la entrega su organización. Las
    rutas de verificación de evidencia

    (`/v1/evidence/*`) no requieren clave.


    ### Créditos y límites

    Cada plan tiene un **límite de pedidos por minuto** y una **cantidad mensual
    de créditos**. Cada operación indica

    su costo en créditos. **Solo se cobran las respuestas correctas (status
    menor que 400):** una respuesta de error

    queda registrada con 0 créditos. El consumo se consulta en `GET
    /v1/account`.


    ### Datos que no se pudieron leer

    Si la fuente de datos no puede leer lo pedido, la respuesta es `503
    source_unavailable`, sin cobro, con la

    fuente, la red, la consulta, el motivo y si conviene reintentar. Si falla un
    paso intermedio, la respuesta es 200

    y lo declara en `degraded_sources` y en el `coverage_gaps` del nodo o la
    arista: en esos casos, la ausencia de

    datos no significa ausencia de movimientos.


    ### Redes

    `ethereum`, `bsc`, `polygon`, `arbitrum`, `base` y `optimism`; además `tron`
    para rastreo, ficha, fondeo, sondeo

    de redes y transacciones. Qué se puede consultar en cada red se indica en
    `GET /v1/chains`, sin costo. Las redes

    `monero`, `bitcoin`, `litecoin` y `solana` se reconocen en `/screening` y
    `/address`, donde la red se deduce del

    formato de la dirección. Cualquier otra red responde `400`: nunca se
    reemplaza por Ethereum.
  contact:
    name: blockgence
    url: https://www.blockgence.com/
  version: 1.0.0
servers:
  - url: https://app.blockgence.com
    description: Producción
security: []
tags:
  - name: Plataforma
    description: >-
      Qué redes hay, qué se puede consultar en cada una, con qué fuentes y con
      qué metodología. Sin costo.
  - name: Rastreo
    description: >-
      Rastreo del flujo de fondos y lecturas de una dirección o una transacción:
      grafo en los dos sentidos con consistencia temporal, fondeo, contrapartes,
      puentes, swaps, mezcladores, etiquetas y datos on-chain.
  - name: Screening
    description: >-
      Screening de riesgo de una dirección, con una recomendación (allow, review
      o block), sus razones y sus fuentes.
  - name: Contratos
    description: Inspección de contratos y simulación de una transacción antes de firmarla.
  - name: Tokens
    description: >-
      Ficha de un token, con su emisor, su suministro, sus tenedores y sus
      señales de riesgo.
  - name: Compromiso
    description: >-
      Vector de compromiso de una billetera robada, es decir, cómo se perdió el
      control de los fondos.
  - name: Incidentes
    description: >-
      Respuesta a incidentes de víctimas, hackeos y estafas: playbook, pedidos
      de congelamiento a emisores, post-mortem y entregables.
  - name: Copiloto
    description: >-
      Copiloto de investigación con IA, que responde en lenguaje natural y cita
      la evidencia (streaming SSE).
  - name: Casos
    description: >-
      Casos de investigación para guardar, compartir y exportar, con su
      evidencia, su actividad y sus anotaciones.
  - name: Permisos
    description: >-
      Aprobaciones, delegaciones y firmas que dan acceso a los fondos de una
      dirección (ERC-20, Permit2 y EIP-7702).
  - name: Guard
    description: >-
      Vigilancia de billeteras y protocolos, con alertas por webhook y por
      correo.
  - name: Travel Rule
    description: >-
      Travel Rule sin conexión con terceros: desafío de titularidad,
      contraparte, conciliación y validación de mensajes IVMS101.
  - name: Auditoría
    description: >-
      Auditoría de smart contracts, con el estado, los hallazgos y la evidencia
      de cada auditoría.
  - name: Evidencia
    description: >-
      Verificación de la evidencia sellada, con la clave pública de firma y los
      sellos de tiempo. No requiere clave de API ni cobra.
  - name: Monero
    description: >-
      Ficha pública de una transacción de Monero y verificación de una prueba de
      pago. Monero no publica remitentes ni montos, por lo que no se rastrea.
  - name: Cuenta
    description: Consumo y límites de su clave de API.
  - name: Íconos
    description: Logos de entidades para mostrar grafos en su propia interfaz. Sin costo.
  - name: Servicio
    description: Estado del servicio.
paths:
  /v1/evidence/timestamp/{name}:
    get:
      tags:
        - Evidencia
      summary: Sello de tiempo de un documento
      description: >-
        Devuelve la prueba OpenTimestamps de un documento que selló este
        servicio, o su estado. No requiere clave de

        API.


        - Con `.ots` al final del nombre, devuelve el archivo de la prueba como
        adjunto
         (`application/vnd.opentimestamps.v1`), con el header `X-OTS-Status`: `pending` o `complete`.
        - Sin `.ots`, devuelve el estado en JSON: `digest`, `status`, los
        bloques de Bitcoin que anclan la prueba con su
         `merkle_root`, los calendarios, las fechas de pedido y de confirmación, el enlace de descarga, qué prueba y qué
         no, y los pasos para verificarla.

        Una prueba pendiente se intenta completar al consultarla, como máximo
        una vez cada 10 minutos por documento.

        Una prueba completa se puede guardar en caché 1 día.


        Errores: un nombre que no es un sha256 en hexadecimal responde `400`; un
        documento que este servicio no selló

        responde `404`.
      operationId: timestamp_proof_v1_evidence_timestamp__name__get
      parameters:
        - name: name
          in: path
          required: true
          schema:
            type: string
            title: Name
          description: >-
            Sha256 del documento sellado, en 64 caracteres hexadecimales. Con el
            sufijo `.ots` devuelve el archivo de la prueba; sin él, su estado en
            JSON.
      responses:
        '200':
          description: El archivo de la prueba (con `.ots`) o su estado en JSON.
          content:
            application/json:
              schema: {}
        '422':
          description: >-
            El pedido no tiene la forma esperada; `detail` indica qué campo
            corregir.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

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