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

# Quickstart

> Get started with the Webacy API in minutes — create an API key, authenticate, and run your first wallet, token, or contract risk-analysis request.

## Prerequisites

Before you begin, ensure you have:

* An API key from [developers.webacy.co](https://developers.webacy.co/)

## Step 1: Get Your API Key

1. Visit [developers.webacy.co](https://developers.webacy.co/) to sign up
2. Generate your API key
3. Copy and securely store your API key

<Warning>
  Keep your API key secret. Never expose it in client-side code or public repositories.
</Warning>

## Step 2: Make Your First Request

Check the risk score of any blockchain address:

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.webacy.com/addresses/0x742d35Cc6634C0532925a3b844Bc454e4438f44e?chain=eth" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.webacy.com/addresses/0x742d35Cc6634C0532925a3b844Bc454e4438f44e?chain=eth',
    {
      headers: {
        'x-api-key': 'YOUR_API_KEY'
      }
    }
  );
  const data = await response.json();
  console.log(data);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.webacy.com/addresses/0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
      params={'chain': 'eth'},
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  print(response.json())
  ```
</CodeGroup>

## Step 3: Understand the Response

```json theme={null}
{
  "count": 1,
  "medium": 0,
  "high": 0,
  "overallRisk": 25.99,
  "issues": [],
  "isContract": false
}
```

| Field         | Description                              |
| ------------- | ---------------------------------------- |
| `overallRisk` | Risk score from 0-100 (higher = riskier) |
| `count`       | Total number of risk factors found       |
| `medium`      | Count of medium-severity issues          |
| `high`        | Count of high-severity issues            |
| `issues`      | Array of specific risk details           |
| `isContract`  | Whether the address is a smart contract  |

<Tip>
  See [Risk Levels](/essentials/risk-levels) for how to interpret the `overallRisk` score.
</Tip>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Screen Wallets" icon="wallet" href="/api-reference/threat-risks/threat-considerations-for-an-address">
    Check if an address is associated with scams, hacks, or sanctions
  </Card>

  <Card title="Analyze Tokens" icon="coins" href="/api-reference/token-analysis/get-token-economic-history">
    Get comprehensive security analysis for any token
  </Card>

  <Card title="Scan Contracts" icon="file-code" href="/api-reference/contract-risk/get-a-real-time-analysis-for-a-given-contract-address">
    Detect vulnerabilities in smart contracts
  </Card>

  <Card title="Transaction Scanning (KYT)" icon="magnifying-glass" href="/api-reference/transaction-scanning/scan-raw-evm-transaction-for-security-risks">
    Know Your Transaction — preview transaction risks before signing
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/introduction">
    Explore all available endpoints
  </Card>

  <Card title="Supported Chains" icon="link-horizontal" href="/essentials/supported-blockchains">
    See all 13 supported blockchains
  </Card>

  <Card title="Risk Modules" icon="shield" href="/essentials/modules">
    Understand our 14 risk analysis modules
  </Card>

  <Card title="Rate Limits" icon="gauge" href="/essentials/rate-limits">
    Check API limits and quotas
  </Card>
</CardGroup>