Currently, eVa AI API are only available for: eth, bsc, base, arb

Request an API key here: https://t.me/EvaAISupportBot

API cost is based on usage and company size

Fetch full audit by chain and contract address for any Token (Limited 60 requests per minute)

Retrieves full token audit information based on the specified blockchain and contract address.

GEThttps://api.eva-ai.cloud/getAuditbyToken/{chain}/{contractAddress}

Path parameters

chain*enum

The blockchain network (eth, bsc, base, sonic)

Example: "eth"

ethbscbasesonic

contractAddress*string

The contract address of the token to audit

Example: "0xYourContractAddress"

Response

200400403429500

Successfully fetched the full audit

Body

application/json

namestring

Name of the project or token

Example: "LILY"

symbolstring

Token symbol

Example: "LILY"

decimalsinteger

Number of decimals for the token

Example: 18

ownerstring

Owner of the token

Example: "0xOwnerAddressHere"

formattedTotalSupplynumber

Total supply of the token in human-readable format

Example: 1000000000

clog_percnumber

Percentage of token clog

Example: 0.05

topHolder_percstring

Percentage of top holder

Example: "20%"

topholdersAnalyzedinteger

Number of top holders analyzed

Example: 100

topHolders_percstring

Percentage of top 8 holders

Example: "15%"

AIauditobject

Request

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getAuditbyToken/{chain}/{contractAddress}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

Response

200

{
  "name": "LILY",
  "symbol": "LILY",
  "decimals": 18,
  "owner": "0xOwnerAddressHere",
  "formattedTotalSupply": 1000000000,
  "clog_perc": 0.05,
  "topHolder_perc": "20%",
  "topholdersAnalyzed": 100,
  "topHolders_perc": "15%",
  "AIaudit": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}

Audit any contract address or token (Limited 60 requests per minute)

Retrieves audit information based on the specified blockchain and any contract address.

GEThttps://api.eva-ai.cloud/getAuditbyAddress/{chain}/{contractAddress}

Path parameters

chain*enum

The blockchain network (eth, bsc, base, sonic)

Example: "eth"

ethbscbasesonic

contractAddress*string

The contract address of the token to audit

Example: "0xYourContractAddress"

Response

200400403404429500

Successfully fetched the audit

Body

application/json

findingsarray of object

List of findings

Privilegesstring

Privileges given in the contract

Example: "🟡"

MaliciousCodestring

Rating of potential malicious code

Example: "🔴"

TaxStructureobject

TransactionLimitstring

Number of tokens allowed per transaction

Example: "8,400,000,000 tokens"

EnforcedForstring

Conditions or events that enforce these limits

Example: "Until the owner removes limits using `removeLimits()`"

Request

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getAuditbyAddress/{chain}/{contractAddress}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

Response

200

{
  "name": "LILY",
  "executiveSummary": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}

Get the latest ETH LP lock + audit (100 requests per minute)

Retrieves the latest LP lock detected by eVa, inclusive of parameters and audit info

GEThttps://api.eva-ai.cloud/getLatestLock

Response

200400

Successfully fetched latest lock

Body

application/json

namestring

Name of the token

Example: "LILY"

symbolstring

Symbol of the token

Example: "LILY"

addressstring

Contract address of the token

Example: "0xYourContractAddress"

clognumber

Clogging percentage of the token

Example: 0.05

renouncedstring

Owner's address, indicating renouncement status if applicable

Example: "0xOwnerAddressHere"

lpLockedPercentagenumber

Percentage of liquidity locked

Example: 25.3

LPvaluenumber

Value of the locked liquidity in ETH

Example: 200000

auditobject

Audit details containing findings and contract security ratings

percLockednumber

Percentage of the token supply that is locked

Example: 85.6

marketcapnumber

Market capitalization of the token

Example: 10000000

evaTimeinteger

Timestamp for the latest lock, in seconds since epoch

Example: 1690000000

Request

JavaScriptPythoncURL

const response = await fetch(`https://api.eva-ai.cloud/getLatestLock`, {
  method: 'GET',
  headers: {
    'x-api-key': 'your-api-key'
  }
});

const data = await response.json();
console.log(data);

Response

200

{
  "name": "LILY",
  "symbol": "LILY",
  "address": "0xYourContractAddress",
  "clog": 0.05,
  "renounced": "0xOwnerAddressHere",
  "lpLockedPercentage": 25.3,
  "LPvalue": 200000,
  "audit": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  },
  "percLocked": 85.6,
  "marketcap": 10000000,
  "evaTime": 1690000000
}

Generate an audit given any code snippet regardless of the chain.

Generate an audit based on the specified code snippet, without requiring chain or contract details.

POSThttps://api.eva-ai.cloud/getAuditbyCode

Body

application/json

codeSnippet*string

The Solidity code snippet to audit.

Response

200400403404429500

Successfully fetched the audit

Body

application/json

findingsarray of object

List of findings

Privilegesstring

Privileges given in the contract

Example: "🟡"

MaliciousCodestring

Rating of potential malicious code

Example: "🔴"

TaxStructureobject

TransactionLimitstring

Number of tokens allowed per transaction

Example: "8,400,000,000 tokens"

EnforcedForstring

Conditions or events that enforce these limits

Example: "Until the owner removes limits using `removeLimits()`"

Request

JavaScriptPythoncURL

const response = await fetch('https://api.eva-ai.cloud/getAuditbyCode', {
  method: 'POST',
  headers: {
    'x-api-key': 'your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    codeSnippet: `pragma solidity ^0.8.0;

contract HelloWorld {
    string public greet = "Hello, World!";
}`
  })
});

const data = await response.json();
console.log(data);

Response

200

{
  "executiveSummary": {
    "findings": [
      {
        "rating": "🔴",
        "issue": "Potential malicious behavior detected."
      }
    ],
    "Privileges": "🔴",
    "MaliciousCode": "🔴",
    "TaxStructure": {
      "Initial Taxes": "15% Buy, 15% Sell",
      "Final Taxes": "0% Buy, 0% Sell",
      "Reduced after": "5 buys"
    },
    "TransactionLimit": "8,400,000,000 tokens",
    "EnforcedFor": "Until the owner removes limits using `removeLimits()`"
  }
}