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

# Stellar Blockchain Risk Analysis

> Stellar blockchain risk analysis with Webacy API including address scans, token risk checks, sanction screening, and supported endpoints overview.

## Overview

The Webacy API provides risk assessment for the Stellar blockchain ecosystem. Analyze Stellar addresses and tokens for security threats, malicious activity, and risk factors.

<Note>
  Stellar support is currently in beta. Contact us at [info@webacy.com](mailto:info@webacy.com) for feedback or questions.
</Note>

## Supported Endpoints

### Address Risk Analysis

Analyze any Stellar address for security threats and risk factors.

```bash theme={null}
GET /addresses/{address}?chain=stellar
```

### Holder Analysis

Analyze token holder distribution and detect suspicious activity.

```bash theme={null}
GET /holder-analysis/{identifier}?chain=stellar
```

## Address Formats

Stellar uses different address formats depending on the entity type:

| Type    | Format               | Example                                                         |
| ------- | -------------------- | --------------------------------------------------------------- |
| Account | G... (56 characters) | `GA223OFHVKVAH2NBXP4AURJRVJTSOVHGBMKJNL6GRJWNN4SARVGSITYG`      |
| Token   | CODE:ISSUER          | `USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN` |

<Warning>
  For token analysis, use the `CODE:ISSUER` format. The code is the asset code (e.g., `USDC`) and the issuer is the account that created the token.
</Warning>

## Test Addresses

Use these addresses to test the API:

```bash theme={null}
# Known malicious address
curl -X GET "https://api.webacy.com/addresses/GA223OFHVKVAH2NBXP4AURJRVJTSOVHGBMKJNL6GRJWNN4SARVGSITYG?chain=stellar" \
  -H "x-api-key: YOUR_API_KEY"

# Token holder analysis
curl -X GET "https://api.webacy.com/holder-analysis/WillowDollar:GAFKQXZYW32INZMX3N4CPB73P3ZYTPHYEZF2HYBHVL6LFPSLLOWPTJVS?chain=stellar" \
  -H "x-api-key: YOUR_API_KEY"
```

## Stellar-Specific Risk Tags

These risk tags are unique to the Stellar ecosystem:

| Tag                                   | Severity | Description                                                                                                                 |
| ------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `stellar-clawback-operations`         | Medium   | A clawback operation has been detected on this account or token.                                                            |
| `stellar-multiple-clawbacks`          | High     | Multiple clawback operations detected, indicating a potential pattern of fund recovery or manipulation.                     |
| `stellar-malicious-account`           | High     | Account flagged as malicious by community threat intelligence.                                                              |
| `stellar-unsafe-account`              | Medium   | Account flagged as potentially unsafe by community threat intelligence.                                                     |
| `stellar-malicious-issuer-token`      | High     | Token issuer has been flagged as malicious.                                                                                 |
| `stellar-unsafe-issuer-token`         | Medium   | Token issuer has been flagged as potentially unsafe.                                                                        |
| `stellar-failed-operations`           | Low      | The account or token has at least one recently failed operation.                                                            |
| `stellar-multiple-failed-operations`  | Medium   | Multiple failed operations detected, which can indicate misconfiguration, contention, or abusive automation.                |
| `stellar-smart-contract-interactions` | Low      | The account has interacted with Soroban smart contracts. Apply contract-level scrutiny in addition to account-level checks. |

## Additional Risk Tags

Standard risk tags also apply to Stellar addresses:

* `wash_trading` - Suspicious trading patterns detected
* `sanctioned` - Address appears on sanction lists
* `insufficient_wallet_age` - Account is very new
* `insufficient_wallet_balance` - Low account balance
* `insufficient_wallet_transactions` - Limited transaction history
* Holder concentration tags (top holders owning significant percentages)

## Example Response

```json theme={null}
{
  "count": 2,
  "medium": 1,
  "high": 1,
  "overallRisk": 65.5,
  "issues": [
    {
      "tag": "stellar-malicious-account",
      "severity": "high",
      "description": "Account flagged as malicious by community threat intelligence"
    },
    {
      "tag": "stellar-clawback-operations",
      "severity": "medium",
      "description": "Clawback operation detected on this account"
    }
  ]
}
```

## Best Practices

1. **Always use the correct format** - Use `CODE:ISSUER` format for tokens, not just the asset code
2. **Check holder distribution** - Use the holder analysis endpoint to understand token concentration
3. **Monitor for clawback** - Clawback-enabled tokens can have funds recalled by the issuer