# For Developers

{% hint style="info" %}
**Good to know:** The API service is available only to token holders.
{% endhint %}

## 🛡️ Rug Checker API

Check whether a token on the Solana network shows potential signs of being a rug pull or contains suspicious parameters like unlocked LPs, lack of freeze authority, or top-heavy holder distribution.

**🔗 Endpoint**

{% code title="http" %}

```
POST https://api.xaxios.com/terminal/rugCheck
```

{% endcode %}

**🧾 Headers**

{% code title="json" %}

```json
{
  "accept": "application/json",
  "content-type": "application/json"
}
```

{% endcode %}

**📦 Request Body**

{% code title="json" %}

```json
{
  "contractAddress": "3hKtBHkMrTkQ7YaxqtyJNq2VuCMNRXBvuWRC9pXXJ8Ej",
  "network": "solana"
}
```

{% endcode %}

<table data-header-hidden><thead><tr><th width="147.5234375"></th><th width="84.74609375"></th><th width="96.46484375"></th><th></th></tr></thead><tbody><tr><td>Parameter</td><td>Type</td><td>Required</td><td>Description</td></tr><tr><td>contractAddress</td><td>string</td><td>✅</td><td>SPL token address to analyze</td></tr><tr><td>network</td><td>enum</td><td>✅</td><td>Blockchain network (see supported values below)</td></tr></tbody></table>

🔽 Supported network values:

<table data-header-hidden><thead><tr><th width="89.51953125"></th><th></th></tr></thead><tbody><tr><td>Value</td><td>Description</td></tr><tr><td>solana</td><td>Solana blockchain</td></tr><tr><td>bnb</td><td>BNB Chain (Binance Smart Chain)</td></tr><tr><td>eth</td><td>Ethereum Mainnet</td></tr><tr><td>base</td><td>Base</td></tr></tbody></table>

**✅ Example Request (JavaScript - fetch)**

{% code title="js" %}

```javascript
fetch("https://api.xaxios.com/terminal/rugCheck", {
  method: "POST",
  headers: {
    "accept": "application/json",
    "content-type": "application/json"
  },
  body: JSON.stringify({
    contractAddress: "3hKtBHkMrTkQ7YaxqtyJNq2VuCMNRXBvuWRC9pXXJ8Ej",
    network: "solana"
  })
});
```

{% endcode %}

**📤 Example Response**

{% code title="" %}

```json
{
  "success": true,
  "data": {
    "contractAddress": "3hKtBHkMrTkQ7YaxqtyJNq2VuCMNRXBvuWRC9pXXJ8Ej",
    "createdAt": "2025-04-07T18:22:15.119Z",
    "mintable": false,
    "lpLocked": {
      "lpLockedPct": 41.78,
      "lpLocked": true
    },
    "freezeAuthority": false,
    "topHolders": [
      {
        "address": "6ek42...",
        "amount": 17921743511270310,
        "decimals": 9,
        "pct": 17.92,
        "uiAmount": 17921743.511,
        "uiAmountString": "17921743.511",
        "owner": "GpMZbSM2...",
        "insider": false,
        "type": "AMM",
        "name": "Raydium CPMM Pool"
      }
      // More holders...
    ],
    "topHolderPercentage": 38.31,
    "isSuspicious": false,
    "coinInfo": {
      "name": "xAxios AI Coin",
      "symbol": "xAxiosAI",
      "twitter": "xaxiosai",
      "telegram": "xaxiosaiportal",
      "discord": null,
      "dexScreenerUrl": "https://dexscreener.com/solana/...",
      "marketCap": 35450,
      "imageUrl": "https://dd.dexscreener.com/ds-data/...",
      "website": "https://xaxios.com/"
    },
    "devTokens": [],
    "devTokensCount": "Coming Soon",
    "securityScore": 100,
    "reasons": []
  }
}
```

{% endcode %}

**📚 Response Fields**

🔸 Token Analysis

<table data-header-hidden><thead><tr><th width="198.9375"></th><th width="108.76953125"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>mintable</td><td>boolean</td><td>Is the token still mintable?</td></tr><tr><td>freezeAuthority</td><td>boolean</td><td>Is freeze authority still active?</td></tr><tr><td>lpLockedPct</td><td>float</td><td>% of LP tokens locked</td></tr><tr><td>lpLocked</td><td>boolean</td><td>Are LP tokens locked?</td></tr><tr><td>topHolderPercentage</td><td>float</td><td>Total percentage held by top 10 wallets</td></tr><tr><td>isSuspicious</td><td>boolean</td><td>AI judgment: is this token risky?</td></tr><tr><td>securityScore</td><td>number</td><td>0–100 score assigned by AI (100 = safest)</td></tr><tr><td>createdAt</td><td>string</td><td>Time this report was generated</td></tr><tr><td></td><td></td><td></td></tr></tbody></table>

🔸 Top Holders

Each item in topHolders includes:

<table data-header-hidden><thead><tr><th width="144.6796875"></th><th width="117.12109375"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>address</td><td>string</td><td>Token account</td></tr><tr><td>amount</td><td>number</td><td>Raw amount (lamports)</td></tr><tr><td>decimals</td><td>number</td><td>Token decimals</td></tr><tr><td>pct</td><td>float</td><td>% of supply held</td></tr><tr><td>uiAmount</td><td>float</td><td>Human-readable amount</td></tr><tr><td>uiAmountString</td><td>string</td><td>Same as above in string format</td></tr><tr><td>owner</td><td>string</td><td>Owner wallet</td></tr><tr><td>type</td><td>string</td><td>Type: WALLET, AMM, LOCKER, etc.</td></tr><tr><td>name</td><td>string</td><td>Platform name (e.g. Raydium, Jupiter)</td></tr><tr><td>insider</td><td>boolean</td><td>Is this wallet labeled as “insider”?</td></tr></tbody></table>

🔸 Token Metadata (coinInfo)

<table data-header-hidden><thead><tr><th width="142.66796875"></th><th width="91.1953125"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>name</td><td>string</td><td>Token name</td></tr><tr><td>symbol</td><td>string</td><td>Token symbol</td></tr><tr><td>marketCap</td><td>number</td><td>Estimated market cap in USD</td></tr><tr><td>website</td><td>string</td><td>Official website</td></tr><tr><td>twitter</td><td>string</td><td>Twitter handle</td></tr><tr><td>telegram</td><td>string</td><td>Telegram community</td></tr><tr><td>discord</td><td>string</td><td>Discord (may be null)</td></tr><tr><td>imageUrl</td><td>string</td><td>Token logo</td></tr><tr><td>dexScreenerUrl</td><td>string</td><td>Link to DEX Screener token analytics</td></tr></tbody></table>

🔸 Dev Tokens&#x20;

It can also be maintenance, follow us on Telegram and X.

<table data-header-hidden><thead><tr><th width="155.46484375"></th><th width="98.953125"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>devTokens</td><td>array</td><td>(Empty or coming soon)</td></tr><tr><td>devTokensCount</td><td>string</td><td>Currently: "Coming Soon"</td></tr></tbody></table>

🔸 AI Flags&#x20;

<table data-header-hidden><thead><tr><th width="91.1171875"></th><th width="82.05078125"></th><th></th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Description</td></tr><tr><td>reasons</td><td>array</td><td>If isSuspicious is true, reasons are listed</td></tr></tbody></table>