BRAINIAC.software API

Token Due Diligence

Independent API for Base Mainnet token due diligence: contract analysis, DEX liquidity inspection, holder concentration analysis, and permission inspection using public JSON-RPC, Uniswap factories, and DeFiLlama.

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

Field	Required	Notes
`tokenAddress`	Yes	string

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

Field	Required	Notes
`tokenAddress`	Yes	string

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

Field	Required	Notes
`tokenAddress`	Yes	string
`deploymentBlock`	No	integer
`fromBlock`	No	integer
`toBlock`	No	integer

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

Field	Required	Notes
`tokenAddress`	Yes	string

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