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

# Wallet background check

> Generates an AI-written background check report about the compliance status and activity of a wallet address.

Runs an AI background check on a wallet address and returns a written report covering its compliance status and on-chain activity.

## Supported wallet formats

The endpoint accepts EVM, Solana, Stellar, Tron, and Bitcoin addresses:

* EVM: `0x` followed by 40 hex characters
* Solana / Tron / Stellar / Bitcoin: standard address formats of each network

## Caching

Reports are cached per address with a TTL. The endpoint returns the cached report when one exists and has not expired; otherwise it generates a fresh one.

| Query parameter | Type    | Description                                                                       |
| --------------- | ------- | --------------------------------------------------------------------------------- |
| `recreate`      | boolean | When `true`, bypasses the cache and forces a fresh AI generation. Default `false` |

## Example

```bash theme={null}
curl -H "x-api-key: ApiKey wavy_..." \
  "https://api.wavynode.com/v1/wallets/0x28C6c06298d514Db089934071355E5743bf21d60/report"
```

## Response

```json theme={null}
{
  "success": true,
  "data": "# Wallet Report\n\n**Address:** 0x28C6...\n**Risk level:** Low\n\n## Activity overview\n..."
}
```

<Note>
  The response `data` field is a markdown string, not a structured object.
</Note>


## OpenAPI

````yaml GET /wallets/{wallet}/report
openapi: 3.1.0
info:
  title: Wavy Node API
  description: >-
    Compliance, fraud prevention, and risk analysis API for payment providers
    and cryptocurrency exchanges in Latin America.
  version: 1.0.0
  contact:
    name: Wavy Node Support
    email: support@wavynode.com
servers:
  - url: https://api.wavynode.com/v1
    description: Production
security:
  - apiKeyAuth: []
paths:
  /wallets/{wallet}/report:
    get:
      tags:
        - Wallets
      summary: Wallet background check
      description: >-
        Generates an AI-written report about the compliance status and activity
        of a wallet address. Results are cached per address; pass recreate=true
        to force a fresh generation.
      operationId: getWalletBackgroundCheck
      parameters:
        - name: wallet
          in: path
          required: true
          description: Wallet address to check (EVM, Solana, Stellar, Tron, or Bitcoin)
          schema:
            type: string
        - name: recreate
          in: query
          required: false
          description: When true, bypasses the cache and regenerates the report
          schema:
            type: boolean
      responses:
        '200':
          description: AI-generated wallet background check report
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: string
                    description: AI-generated report in markdown format
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Enter the full value with the `ApiKey` prefix. Example: `ApiKey
        wavy_your-api-key`. The prefix is required for authentication.

````