Skip to main content

​
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.
Stellar support is currently in beta. Contact us at [email protected] for feedback or questions.

​
Supported Endpoints

​
Address Risk Analysis

Analyze any Stellar address for security threats and risk factors. 
GET /addresses/{address}?chain=stellar

​
Holder Analysis

Analyze token holder distribution and detect suspicious activity. 
GET /holder-analysis/{identifier}?chain=stellar

​
Address Formats

Stellar uses different address formats depending on the entity type:
TypeFormatExample
AccountG… (56 characters)GA223OFHVKVAH2NBXP4AURJRVJTSOVHGBMKJNL6GRJWNN4SARVGSITYG
TokenCODE:ISSUERUSDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
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.

​
Test Addresses

Use these addresses to test the API: 
# 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:
TagSeverityDescription
clawbackMediumA clawback operation has been detected on this account or token.
multiple_clawbackHighMultiple clawback operations detected, indicating potential pattern of fund recovery or manipulation.
malicious_accountHighAccount flagged as malicious by StellarExpert or community reports.
unsafe_accountMediumAccount flagged as potentially unsafe by StellarExpert.
malicious_issuerHighToken issuer has been flagged as malicious.
unsafe_issuerMediumToken issuer has been flagged as potentially unsafe.

​
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

{
  "count": 2,
  "medium": 1,
  "high": 1,
  "overallRisk": 65.5,
  "issues": [
    {
      "tag": "malicious_account",
      "severity": "high",
      "description": "Account flagged as malicious by StellarExpert"
    },
    {
      "tag": "clawback",
      "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