Stellar Blockchain Risk Analysis

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 info@webacy.com 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:

Type	Format	Example
Account	G… (56 characters)	`GA223OFHVKVAH2NBXP4AURJRVJTSOVHGBMKJNL6GRJWNN4SARVGSITYG`
Token	CODE:ISSUER	`USDC: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:

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

{
  "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

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

​Overview

​Supported Endpoints

​Address Risk Analysis

​Holder Analysis

​Address Formats

​Test Addresses

​Stellar-Specific Risk Tags

​Additional Risk Tags

​Example Response

​Best Practices

Overview

Supported Endpoints

Address Risk Analysis

Holder Analysis

Address Formats

Test Addresses

Stellar-Specific Risk Tags

Additional Risk Tags

Example Response

Best Practices