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

# Introduction

> Compliance, fraud prevention, and risk analysis API for payment providers and crypto exchanges in Latin America.

The Wavy Node API lets you analyze blockchain addresses, monitor wallets, and manage compliance workflows for your projects.

## Base URL

```
https://api.wavynode.com/v1
```

## Authentication

All endpoints require your API key in the `x-api-key` HTTP header. The value must include the `ApiKey` prefix:

```bash highlight={1} theme={null}
curl -H "x-api-key: ApiKey wavy_your_api_key_here" \
  https://api.wavynode.com/v1/chains
```

Get your API key from the [Wavy Node dashboard](https://wavynode.com/dashboard).

<Warning>
  Always include the `ApiKey` prefix before your key. The correct format is:

  ```highlight={1} theme={null}
  x-api-key: ApiKey wavy_...
  ```

  Sending only the key without the prefix (e.g., `x-api-key: wavy_...`) will result in an authentication error.
</Warning>

<Note>
  Some API routes require you to provide the `projectId` in the URL. You can find your project's `projectId` in the dashboard under **Project Settings**.
</Note>

## Response format

All responses use JSON with a consistent structure:

| Field     | Type    | Required | Description                         |
| --------- | ------- | -------- | ----------------------------------- |
| `success` | boolean | yes      | Whether the request was successful  |
| `data`    | any     | no       | Response payload                    |
| `message` | string  | no       | Additional context or error message |

### Error example

```json theme={null}
{
  "success": false,
  "error": "invalid_request",
  "message": "The api key is invalid"
}
```

## Available endpoints

<CardGroup cols={2}>
  <Card title="Chains" icon="link" href="/api-reference/endpoint/list-chains">
    Get information about supported blockchain networks.
  </Card>

  <Card title="Wallets" icon="wallet" href="/api-reference/endpoint/get-wallet-status">
    Check wallet status, balance, and generate AI reports.
  </Card>

  <Card title="Scan Risk" icon="magnifying-glass-dollar" href="/api-reference/endpoint/get-scan-risk-results">
    Analyze blockchain addresses for risk and suspicious patterns.
  </Card>

  <Card title="Investigations" icon="magnifying-glass" href="/api-reference/endpoint/create-investigation">
    Create investigations with standard or incremental layer-by-layer analysis.
  </Card>

  <Card title="Analysis" icon="layer-group" href="/api-reference/endpoint/get-analysis-progress">
    Track incremental analysis progress and fetch per-layer results.
  </Card>

  <Card title="Reports" icon="file-lines" href="/api-reference/endpoint/list-reports">
    Auto-generated regulatory compliance reports (MX, CO, SV, GT).
  </Card>

  <Card title="Addresses" icon="map-pin" href="/api-reference/endpoint/list-addresses">
    Manage relevant on-chain addresses for compliance monitoring.
  </Card>

  <Card title="API Keys" icon="key" href="/api-reference/endpoint/list-api-keys">
    Manage API keys for your projects programmatically.
  </Card>
</CardGroup>