Helious API

Integrate smart contract analysis directly into your dApp, wallet, or security tool. All endpoints are REST-based and return JSON.

Base URL: heliouss.vercel.app

v1.0 — Ethereum Mainnet

Authentication

Helious API is currently open — no API key required during the beta. Rate limiting is applied per IP. Future versions will support token-based auth for higher limits.

// No auth header needed during beta
fetch('https://heliouss.vercel.app/api/analyze', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ address: '0x...' })
})

Endpoints

Request body

{
  "address": "0x6B175474E89094C44Da98b954EedeAC495271d0F"
}

Response

{
  "contractName": "Dai",
  "summary": "This is the DAI stablecoin contract...",
  "safety_score": 92,
  "risk_level": "safe",
  "risks": [
    {
      "severity": "low",
      "description": "Owner can add/remove authorized addresses."
    }
  ],
  "functions": [
    {
      "name": "transfer",
      "description": "Moves DAI tokens between addresses."
    }
  ]
}

Request body

{
  "question": "Can this contract withdraw my funds?",
  "context": "Contract: Dai. Summary: This is the DAI stablecoin..."
}

Response

{
  "reply": "This contract cannot directly withdraw funds from your wallet. It can only move tokens you explicitly approve via the approve() function."
}

Models

Helious uses Groq-hosted open models under the hood. The default model is optimized for accuracy on Solidity code. You can request a specific model via the optional model field.

Model	Provider	Avg Speed	Notes
llama-3.3-70b-versatile	Groq	~1.2s	Default. Best accuracy.
llama-3.1-8b-instant	Groq	~0.4s	Faster, slightly less accurate.
mixtral-8x7b-32768	Groq	~0.8s	Good for long contracts.

Errors

400

Bad Request

Invalid or missing Ethereum address.

404

Not Found

Contract not found or source not verified on Etherscan.

429

Rate Limited

Too many requests. Wait and retry.

500

Server Error

AI model failed to parse contract. Try again.