// API_REFERENCE

GoldenBit.ai REST API

Integrate the 6-Pillar AI Risk Engine directly into your exchange, launchpad, or wallet. All responses are JSON. Authentication uses Bearer tokens.

BASE URL: https://api.goldenbit.ai
VERSION: v1
// AUTHENTICATION

All API requests require a Bearer token in the Authorization header. Generate your API key from the API Keys page.

Authorization: Bearer gb_live_your_api_key_here
// RATE_LIMITS
PLAN
REQUESTS
RATE LIMIT
ENDPOINTS
Free
N/A
N/A
No API access
Pro
10,000/month
60 req/min
Scan, Leaderboard
Enterprise
100,000/month
600 req/min
All endpoints + Webhooks
// ENDPOINTS

Analyze a token contract address and return the full 6-Pillar risk score breakdown.

PARAMETERS
addressstringrequiredContract address (0x... for EVM chains)
chainstringChain ID: ethereum, bsc, solana, polygon (default: ethereum)
EXAMPLE REQUEST
curl -X GET "https://api.goldenbit.ai/v1/scan/0x8076c74c5e3f5852037f31ff0093a41b4c29e0b3?chain=ethereum" \
  -H "Authorization: Bearer gb_live_your_api_key_here"
EXAMPLE RESPONSE
{
  "tokenName": "SafeMoon Pro",
  "tokenSymbol": "SMOONP",
  "contractAddress": "0x8076c74c5e3f...",
  "chain": "ethereum",
  "overallScore": 87,
  "overallStatus": "HIGH RISK",
  "pillars": [
    {
      "id": "smart-contract",
      "title": "Smart Contract Audit",
      "weight": 40,
      "score": 92,
      "status": "DANGER",
      "finding": "CRITICAL: Hidden mint function detected"
    },
    ...
  ],
  "metadata": {
    "txCount": 12847,
    "holders": 3421,
    "liquidity": "890K",
    "chain": "ethereum"
  },
  "scannedAt": "2026-03-24T22:00:00.000Z"
}
// GET_STARTED

Ready to Integrate?

Get your API key and start protecting your users from crypto fraud in minutes.