Token Due Diligence API Documentation

Independent API for Base Mainnet token due diligence: contract analysis, DEX liquidity inspection, holder concentration analysis, permission inspection, honeypot checks, and security reports using public JSON-RPC, Uniswap factories, DeFiLlama, and Honeypot.is. Payment is the exact USDC price on Base with x402.

POSThttps://brainiac.software/api/v1/token-due-diligence/analyze$0.05 USDC

Analyze token contract

Analyze a token contract on Base Mainnet including bytecode, ERC-20 metadata, owner, proxy status, and privileges.

Body

FieldRequiredNotes
tokenAddressYesstring

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "chainId": 8453,
  "analysis": {
    "hasCode": true,
    "bytecode": "0x608060405234801561001057600080fd5b50600436106100...",
    "bytecodeLength": 2456,
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6,
    "totalSupply": "1000000000000000000000000000",
    "owner": null,
    "paused": false,
    "isProxy": false,
    "implementation": null,
    "beacon": null,
    "admin": null,
    "mintable": false,
    "burnable": true,
    "priceUsd": 1
  },
  "sources": [
    {
      "source": "Base JSON-RPC",
      "url": "https://mainnet.base.org",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "DeFiLlama",
      "url": "https://api.llama.fi/prices/current",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Contract analysis is based on standard ERC-20 methods and EIP-1967 proxy slots.",
    "Unsupported methods do not imply safety.",
    "Proxy detection is based on EIP-1967 standard slots only."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/analyze" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON
POSThttps://brainiac.software/api/v1/token-due-diligence/liquidity$0.05 USDC

Inspect DEX liquidity

Inspect supported DEX liquidity pools on Base Mainnet using official Uniswap V2 and V3 factories.

Body

FieldRequiredNotes
tokenAddressYesstring

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "chainId": 8453,
  "liquidity": {
    "pools": [
      {
        "type": "V2",
        "address": "0x1234567890123456789012345678901234567890",
        "token0": "0x4200000000000000000000000000000000000006",
        "token1": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
        "token0Symbol": "WETH",
        "token1Symbol": "USDC",
        "reserve0": "100000000000000000000",
        "reserve1": "500000000000",
        "token0Amount": 100,
        "token1Amount": 500000,
        "price": 5000,
        "quoteToken": "0x4200000000000000000000000000000000000006",
        "liquidityValueUsd": 1250000
      }
    ],
    "poolCount": 1,
    "supportedPools": true,
    "priceUsd": 1
  },
  "sources": [
    {
      "source": "Base JSON-RPC",
      "url": "https://mainnet.base.org",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    },
    {
      "source": "DeFiLlama",
      "url": "https://api.llama.fi/prices/current",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Liquidity inspection is limited to official Uniswap V2 and V3 factories.",
    "Only WETH and native USDC quote tokens are checked.",
    "Other DEXs and liquidity pools are not included."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/liquidity" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON
POSThttps://brainiac.software/api/v1/token-due-diligence/holders$0.10 USDC

Analyze holder concentration

Analyze holder concentration from transfer events when complete transfer history is available on Base Mainnet.

Body

FieldRequiredNotes
tokenAddressYesstring
deploymentBlockNointeger
fromBlockNointeger
toBlockNointeger

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "deploymentBlock": 18000000
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "fromBlock": 18000000,
  "toBlock": 18001000,
  "currentBlock": 18001000,
  "scannedBlockRange": "18000000-18001000",
  "holders": {
    "totalTransfers": 1523,
    "holderCount": 842,
    "top10": [
      {
        "address": "0x1234567890123456789012345678901234567890",
        "balance": "100000000000000000000000"
      },
      {
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "balance": "50000000000000000000000"
      }
    ],
    "top20": [
      {
        "address": "0x1234567890123456789012345678901234567890",
        "balance": "100000000000000000000000"
      },
      {
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "balance": "50000000000000000000000"
      }
    ],
    "top10Percentage": 15,
    "top20Percentage": 22,
    "burnHoldings": "0",
    "zeroMintCount": 0,
    "totalSupply": "1000000000000000000000000000",
    "supplyMatch": true
  },
  "sources": [
    {
      "source": "Base JSON-RPC",
      "url": "https://mainnet.base.org",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Block range is limited to 10000 blocks.",
    "Supply deployment block for complete holder history.",
    "Partial history may not represent complete distribution."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/holders" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "deploymentBlock": 18000000
}
JSON
POSThttps://brainiac.software/api/v1/token-due-diligence/permissions$0.03 USDC

Inspect contract permissions

Inspect contract ownership and privileged controls on Base Mainnet including owner, admin, and upgradeability.

Body

FieldRequiredNotes
tokenAddressYesstring

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "chainId": 8453,
  "permissions": {
    "owner": null,
    "paused": false,
    "implementation": null,
    "beacon": null,
    "admin": null,
    "mintable": false,
    "burnable": true,
    "hasOwner": false,
    "hasAdmin": false,
    "hasUpgradeability": false,
    "privileges": [
      "burnable"
    ]
  },
  "sources": [
    {
      "source": "Base JSON-RPC",
      "url": "https://mainnet.base.org",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Permission inspection is based on standard ERC-20 methods and EIP-1967 proxy slots.",
    "Owner and admin depend on standard naming conventions.",
    "Missing methods do not imply absence of privileges."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/permissions" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON
POSThttps://brainiac.software/api/v1/token-due-diligence/honeypot$0.05 USDC

Check honeypot status

Check if a token is a honeypot using Honeypot.is simulation, including buy/sell tax, gas information, and contract verification.

Body

FieldRequiredNotes
tokenAddressYesstring
pairAddressNostring

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "honeypot": {
    "token": {
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
      "totalHolders": 1755847
    },
    "summary": {
      "risk": "very_low",
      "riskLevel": 0
    },
    "simulationSuccess": true,
    "honeypotResult": {
      "isHoneypot": false
    },
    "simulationResult": {
      "buyTax": 0,
      "sellTax": 0,
      "transferTax": 0,
      "buyGas": "154591",
      "sellGas": "107886"
    },
    "flags": [],
    "contractCode": {
      "openSource": true,
      "rootOpenSource": true,
      "isProxy": false,
      "hasProxyCalls": false
    }
  },
  "sources": [
    {
      "source": "Honeypot API",
      "url": "https://api.honeypot.is/v2/IsHoneypot",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Honeypot simulation results are not guarantees of safety.",
    "Simulation results may not reflect actual market conditions.",
    "Contract verification depends on source code availability."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/honeypot" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
JSON
POSThttps://brainiac.software/api/v1/token-due-diligence/security-report$0.10 USDC

Generate security report

Generate a combined security report using Honeypot checks.

Body

FieldRequiredNotes
tokenAddressYesstring
pairAddressNostring
includeHoneypotYesboolean; Default: true
includeMarketActivityYesboolean; Default: true

Request exampleJSON

{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "includeHoneypot": true
}

Response exampleJSON

{
  "retrievedAt": "2026-10-29T12:00:00.000Z",
  "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bdA02913",
  "findings": {
    "honeypot": {
      "summary": {
        "risk": "very_low",
        "riskLevel": 0
      },
      "simulationSuccess": true,
      "honeypotResult": {
        "isHoneypot": false
      }
    }
  },
  "sources": [
    {
      "source": "Honeypot API",
      "url": "https://api.honeypot.is/v2/IsHoneypot",
      "retrievedAt": "2026-10-29T12:00:00.000Z"
    }
  ],
  "limitations": [
    "Security report combines multiple sources with different coverage.",
    "Honeypot simulation results are not guarantees of safety.",
    "This report does not guarantee the safety of any token."
  ]
}

cURL

curl -i -X POST "https://brainiac.software/api/v1/token-due-diligence/security-report" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "includeHoneypot": true
}
JSON