> ## 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.

# Fuente inicial de fondos ("Funded by") — sender de la primera tx entrante, resuelto contra el diccionario de entidades

> Fuente inicial de fondos de una address (equivalente al "Funded by" de Etherscan,
resuelto contra el diccionario de entidades del proyecto). Idempotente.
Si la fuente no se puede consultar → 503 (antes: 200 «sin transferencias entrantes»).

`degraded_sources` trae los límites de cobertura de la lectura (stages `funding.window`,
`funding.source_incomplete`): lo que impide afirmar que ese fondeo es el PRIMERO. Con esos
límites la `note` del caso sin fondeo cambia, porque «no encontré» no es «no hubo».

`funded_via` (desde el 2026-09-24, `swaps_back.funding_via`): si el fondeador es un contrato (un router, la
nativa envuelta, un pool), si ese primer fondeo fue la salida de un swap que pagó el FIRMANTE de la tx
(`state: followed`, `payer`: quien puso la plata) o de una conversión del propio nodo, como un `SwapLeg`;
null = no se miró (fondeador EOA) o no fue una conversión. Si la tx no se pudo leer, la falla va en
`degraded_sources` (stage `trace.funding_via`) y `funded_via` es null: no es «no fue un swap».

`funded_by_privacy` (desde 2026.10.05c): si el fondeador es un exchanger sin KYC del registro, el origen POSIBLE
en Monero (`status` possible | unknown, con el motivo y la fuente): del otro lado del cambio pudo entrar XMR. No
se afirma y no suma riesgo; null = no aplica.

En Tron, desde 2026.10.12d, `funded_via` se decide con la vista evm20 (`detection/tron_view`), como un swap de
SunSwap V2 del /trace. El hueco de las internas de una tx que firmó otro va en `degraded_sources`
(`funding.internal_gap`) cuando no hay fuente de internas.

Desde 2026.11.13 0x0 y el EntryPoint de 4337 ya no salen como fondeador. `funding_crossing`: el fondeo
es el mint de un cruce CCTP atestado; «Funded by» es la MessageTransmitter (categoría `bridge`) y el objeto dice de
qué chain vino (`src_chain`, `src_domain`), quién quemó del otro lado (`src_sender`) y el `nonce`. `funding_mint`: el
primer ingreso es un mint sin identificar; `funded_by` es null y no se atribuye. `skipped_infra`: entradas
anteriores de un EntryPoint (gas de la propia cuenta) que no cuentan como fondeo.

Desde 2026.11.16e `unpriced_from_exchange`: entradas anteriores de un token sin precio publicado que
una wallet de exchange etiquetada mandó y firmó con un `transfer()` directo. Son reales, pero no cuentan como fondeo
(no se verificó su valor) y no cambian `funded_by`.

**Costo:** 1 crédito de base (solo si la respuesta es < 400; algunas rutas cobran menos si reusan un resultado guardado).



## OpenAPI

````yaml /openapi.json get /v1/funding/{addr}
openapi: 3.1.0
info:
  title: blockgence API
  description: >

    **blockgence** expone como API todo el motor de *blockchain intelligence*:

    rastreo de fondos (tracing), atribución de entidades y screening de riesgo

    explicable (glass-box), sobre múltiples chains EVM.


    ### Autenticación

    Todas las rutas `/v1/*` requieren una **API key**. Mandala en el header

    `X-API-Key: <key>` (o `Authorization: Bearer <key>`). La key te la entrega
    tu

    organización o el administrador. En esta página: **Authorize** → pegá la
    key, y cada

    «Try it out» → «Execute» es una request real, que se cobra igual que desde
    tu código.

    Las rutas de verificación de evidencia (`/v1/evidence/*`) son abiertas.


    ### Límites

    Cada tier tiene un **rate-limit por minuto** y una **cuota mensual de
    créditos**.

    Cada endpoint consume créditos según su costo (`/trace` es el más caro); el
    costo puede

    variar por método y sub-ruta. **Solo se cobran las respuestas exitosas
    (status < 400)**:

    una request que termina en error queda registrada con 0 créditos. Consultá
    tu consumo en

    tiempo real con `GET /v1/account`.


    ### Fallas de la fuente de datos

    Si la fuente de datos falla al leer lo que pediste, la respuesta es `503
    source_unavailable`

    (sin cobro), con la fuente, la chain, la consulta, el motivo y si conviene
    reintentar. Si

    falla un salto intermedio, la respuesta es 200 y lo declara en
    `degraded_sources` (y en el

    `coverage_gaps` del nodo o la arista): ahí, la ausencia de datos no es
    ausencia de movimientos.


    ### Chains soportadas

    `ethereum`, `bsc`, `polygon`, `arbitrum`, `base`, `optimism`; además `tron`
    (rastreo, ficha, fondeo, probe y tx: ver «Tron» en `docs/API.md`). Qué
    fuente sirve cada consulta y con qué límite está en `GET /v1/chains` (0
    créditos). Conocidas y no consultadas (valen en `/screening` y `/address`,
    donde la chain la define el formato de la address): `monero`, `bitcoin`,
    `litecoin`, `solana`.

    Cualquier otra chain es `400`: nunca se sustituye 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: Platform
    description: >-
      Qué chains hay y qué puede servir cada una (registro y matriz de
      capacidades), con qué fuentes y con qué metodología. Costo: 0 créditos.
  - name: Tracking
    description: >-
      Rastreo del flujo de fondos y lecturas de una address o una tx: grafo
      bidireccional con consistencia temporal, fondeo, contrapartes, bridges,
      swaps, mixers, labels y datos on-chain.
  - name: Screening
    description: >-
      Screening de riesgo: ¿esta address es riesgosa? Recomendación
      allow/review/block, con las razones y su fuente.
  - name: Contracts
    description: Inspector de contratos y simulación de transacciones antes de firmar.
  - name: Tokens
    description: 'Ficha de un token: emisor, supply, holders y señales de riesgo.'
  - name: Compromise
    description: 'Vector de compromiso de una wallet robada: cómo se perdió el control.'
  - name: Incident
    description: >-
      Respuesta a incidentes: víctima, hack y estafa. Playbook, freeze de fondos
      en emisores, post-mortem y entregables.
  - name: Copilot
    description: >-
      Copiloto forense con IA: investigá en lenguaje natural, con narrativa
      citada (streaming SSE).
  - name: Cases
    description: >-
      Casos: guardar, compartir y exportar investigaciones, con su evidencia,
      actividad y anotaciones.
  - name: Permissions
    description: >-
      Approvals, delegaciones y firmas que dan acceso a los fondos de una
      address (ERC-20, Permit2, EIP-7702).
  - name: Guard
    description: >-
      Blockgence Guard: vigilancia activa de wallets y protocolos, con alertas
      por webhook y correo.
  - name: Travel Rule
    description: >-
      Travel Rule sin red: desafío de titularidad, contraparte, conciliación y
      validación de mensajes IVMS101.
  - name: Auditoría
    description: >-
      Auditoría de smart contracts: pedir una revisión, su estado y hallazgos,
      las addresses desplegadas y las notas del equipo.
  - name: Evidencia
    description: >-
      Verificación de la evidencia sellada: clave pública de firma y sellos de
      tiempo. Abiertas: no piden API key ni cobran.
  - name: Monero
    description: >-
      Ficha pública de una tx de Monero y prueba de pago XMR (tx key u
      OutProof/InProof), verificada localmente y sellada. Monero no publica
      remitentes ni montos: no se rastrea.
  - name: Account
    description: Tu consumo y límites (self-service).
  - name: Icons
    description: >-
      Logos de entidades para renderizar grafos en tu UI. Cache-first
      (TrustWallet, 1inch, favicons oficiales). Costo: 0 créditos.
  - name: Meta
    description: Health y estado operacional (sin auth).
paths:
  /v1/funding/{addr}:
    get:
      tags:
        - Tracking
      summary: >-
        Fuente inicial de fondos ("Funded by") — sender de la primera tx
        entrante, resuelto contra el diccionario de entidades
      description: >-
        Fuente inicial de fondos de una address (equivalente al "Funded by" de
        Etherscan,

        resuelto contra el diccionario de entidades del proyecto). Idempotente.

        Si la fuente no se puede consultar → 503 (antes: 200 «sin transferencias
        entrantes»).


        `degraded_sources` trae los límites de cobertura de la lectura (stages
        `funding.window`,

        `funding.source_incomplete`): lo que impide afirmar que ese fondeo es el
        PRIMERO. Con esos

        límites la `note` del caso sin fondeo cambia, porque «no encontré» no es
        «no hubo».


        `funded_via` (desde el 2026-09-24, `swaps_back.funding_via`): si el
        fondeador es un contrato (un router, la

        nativa envuelta, un pool), si ese primer fondeo fue la salida de un swap
        que pagó el FIRMANTE de la tx

        (`state: followed`, `payer`: quien puso la plata) o de una conversión
        del propio nodo, como un `SwapLeg`;

        null = no se miró (fondeador EOA) o no fue una conversión. Si la tx no
        se pudo leer, la falla va en

        `degraded_sources` (stage `trace.funding_via`) y `funded_via` es null:
        no es «no fue un swap».


        `funded_by_privacy` (desde 2026.10.05c): si el fondeador es un exchanger
        sin KYC del registro, el origen POSIBLE

        en Monero (`status` possible | unknown, con el motivo y la fuente): del
        otro lado del cambio pudo entrar XMR. No

        se afirma y no suma riesgo; null = no aplica.


        En Tron, desde 2026.10.12d, `funded_via` se decide con la vista evm20
        (`detection/tron_view`), como un swap de

        SunSwap V2 del /trace. El hueco de las internas de una tx que firmó otro
        va en `degraded_sources`

        (`funding.internal_gap`) cuando no hay fuente de internas.


        Desde 2026.11.13 0x0 y el EntryPoint de 4337 ya no salen como fondeador.
        `funding_crossing`: el fondeo

        es el mint de un cruce CCTP atestado; «Funded by» es la
        MessageTransmitter (categoría `bridge`) y el objeto dice de

        qué chain vino (`src_chain`, `src_domain`), quién quemó del otro lado
        (`src_sender`) y el `nonce`. `funding_mint`: el

        primer ingreso es un mint sin identificar; `funded_by` es null y no se
        atribuye. `skipped_infra`: entradas

        anteriores de un EntryPoint (gas de la propia cuenta) que no cuentan
        como fondeo.


        Desde 2026.11.16e `unpriced_from_exchange`: entradas anteriores de un
        token sin precio publicado que

        una wallet de exchange etiquetada mandó y firmó con un `transfer()`
        directo. Son reales, pero no cuentan como fondeo

        (no se verificó su valor) y no cambian `funded_by`.


        **Costo:** 1 crédito de base (solo si la respuesta es < 400; algunas
        rutas cobran menos si reusan un resultado guardado).
      operationId: funding_v1_funding__addr__get
      parameters:
        - name: addr
          in: path
          required: true
          schema:
            type: string
            title: Addr
          description: >-
            Address a consultar, de una cuenta o un contrato. En chains EVM: 0x
            + 40 hex (no distingue mayúsculas); en las rutas que aceptan
            `chain=tron`, base58check `T…`.
        - name: chain
          in: query
          required: false
          schema:
            type: string
            title: Chain
            default: ethereum
          description: >-
            Id de la chain a consultar (ver GET /v1/chains). Default `ethereum`.
            Una chain que blockgence no consulta responde 400.
        - name: X-Case-Id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Case-Id
          description: >-
            Caso activo (opcional): el token de un caso que podés ver. La
            consulta queda en el registro de actividad de ese caso y resuelve
            también sus labels propias. Un caso que no existe, se borró o ya no
            está compartido con vos da `400 case_unavailable` y la consulta no
            se hace (sin cobro).
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '401':
          description: Falta la API key o es inválida o revocada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: Cuota mensual de créditos agotada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            Rate limit por minuto superado. Reintentá después de `Retry-After`
            segundos.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: >-
            `source_unavailable`: la fuente de datos (o el índice de labels) no
            pudo leer lo pedido. Sin cobro. Si falla un salto intermedio la
            respuesta es 200 y lo declara en `degraded_sources`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SourceUnavailable'
      security:
        - APIKeyHeader: []
        - BearerAuth: []
components:
  schemas:
    Error:
      type: object
      title: Error
      description: >-
        Forma de todos los errores: un `detail` legible. Algunos agregan
        `error`, un código estable para reconocerlo sin leer el texto
        (`case_unavailable`, `case_read_only`, …).
      properties:
        detail:
          type: string
          description: Qué pasó, en una frase.
        error:
          type: string
          description: Código estable del error, cuando lo tiene.
      required:
        - detail
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SourceUnavailable:
      type: object
      title: SourceUnavailable
      description: >-
        La fuente de datos no pudo leer lo pedido. No se cobran créditos. La
        ausencia de datos NO dice que la address esté limpia ni sin movimientos.
      properties:
        error:
          type: string
          enum:
            - source_unavailable
        detail:
          type: string
          description: Qué falló, dónde y si conviene reintentar.
        source:
          type: string
          description: >-
            Fuente que falló: `etherscan`, `blockscout`, `bitquery`, `goplus`,
            `osint`, `config`, …
        chain:
          type: string
        primitive:
          type: string
          description: Lectura de blockgence que falló.
        operation:
          type: string
          description: Llamada concreta a la fuente.
        target:
          type: string
          description: Lo consultado (address o tx), abreviado.
        reason:
          type: string
          description: >-
            Motivo estable: `rate_limited`, `quota_exhausted`, `not_in_plan`,
            `unauthorized`, `timeout`, `network`, `upstream_error`, … (tabla en
            docs/API.md).
        retryable:
          type: boolean
        http_status:
          type:
            - integer
            - 'null'
        retry_after:
          type:
            - integer
            - 'null'
          description: Segundos; viene también como header `Retry-After`.
        upstream_message:
          type:
            - string
            - 'null'
        source_fault:
          type: boolean
          description: >-
            Si fue una falla de la fuente o un tope de blockgence / una consulta
            que no se hizo.
        failure_cause:
          type: string
          description: Por qué, en una cláusula.
      required:
        - error
        - detail
        - source
        - reason
        - retryable
    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
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
      description: Tu API key en el header `X-API-Key`.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        La misma API key en `Authorization: Bearer <key>` (alternativa a
        `X-API-Key`).

````

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