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

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

Monitor your api usage and credits here: https://t.me/eVa_Tracking_Bot

(command is /api <YOUR_API_KEY>)

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

get

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

Path parameters

chainstring · enumRequired

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

Example: ethPossible values:

contractAddressstringRequired

The contract address of the token to audit

Example: 0xYourContractAddress

Responses

200

Successfully fetched the full audit

application/json

namestringOptional

Name of the project or token

Example: LILY

symbolstringOptional

Token symbol

Example: LILY

decimalsintegerOptional

Number of decimals for the token

Example: 18

ownerstringOptional

Owner of the token

Example: 0xOwnerAddressHere

formattedTotalSupplynumberOptional

Total supply of the token in human-readable format

Example: 1000000000

clog_percnumberOptional

Percentage of token clog

Example: 0.05

topHolder_percstringOptional

Percentage of top holder

Example: 20%

topholdersAnalyzedintegerOptional

Number of top holders analyzed

Example: 100

topHolders_percstringOptional

Percentage of top 8 holders

Example: 15%

400

Bad Request: Invalid chain, address, or token

application/json

403

Forbidden: Invalid API key

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/getAuditbyToken/{chain}/{contractAddress}

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);

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

get

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

Path parameters

chainstring · enumRequired

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

Example: ethPossible values:

contractAddressstringRequired

The contract address of the token to audit

Example: 0xYourContractAddress

Responses

200

Successfully fetched the audit

application/json

PrivilegesstringOptional

Privileges given in the contract

Example: 🟡

MaliciousCodestringOptional

Rating of potential malicious code

Example: 🔴

TransactionLimitstringOptional

Number of tokens allowed per transaction

Example: 8,400,000,000 tokens

EnforcedForstringOptional

Conditions or events that enforce these limits

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

400

Bad Request: Invalid chain or contract address

application/json

403

Forbidden: Invalid API key

application/json

404

Audit or source code not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/getAuditbyAddress/{chain}/{contractAddress}

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);

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

get

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

Responses

200

Successfully fetched latest lock

application/json

namestringOptional

Name of the token

Example: LILY

symbolstringOptional

Symbol of the token

Example: LILY

addressstringOptional

Contract address of the token

Example: 0xYourContractAddress

clognumberOptional

Clogging percentage of the token

Example: 0.05

renouncedstringOptional

Owner's address, indicating renouncement status if applicable

Example: 0xOwnerAddressHere

lpLockedPercentagenumberOptional

Percentage of liquidity locked

Example: 25.3

LPvaluenumberOptional

Value of the locked liquidity in ETH

Example: 200000

percLockednumberOptional

Percentage of the token supply that is locked

Example: 85.6

marketcapnumberOptional

Market capitalization of the token

Example: 10000000

evaTimeintegerOptional

Timestamp for the latest lock, in seconds since epoch

Example: 1690000000

400

Bad Request: Invalid chain or contract address

application/json

get

/getLatestLock

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);

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

post

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

Body

application/json

codeSnippetstringRequired

The Solidity code snippet to audit.

Responses

200

Successfully fetched the audit

application/json

PrivilegesstringOptional

Privileges given in the contract

Example: 🟡

MaliciousCodestringOptional

Rating of potential malicious code

Example: 🔴

TransactionLimitstringOptional

Number of tokens allowed per transaction

Example: 8,400,000,000 tokens

EnforcedForstringOptional

Conditions or events that enforce these limits

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

400

Bad Request: Code snippet is required

application/json

403

Forbidden: Invalid API key

application/json

404

Audit or source code not found

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

post

/getAuditbyCode

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);

{
  "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()`"
  }
}