FUD.ai logoFUD.ai

POST /api/agent

Submit a new FUD.ai analysis request. Returns 202 Accepted with a job_id for polling.

Request

POST /api/agent HTTP/1.1
Content-Type: application/json
X-Demo-Fingerprint: {your_fingerprint}

{
  "coin_symbol": "PEPE",
  "contract_address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain_id": "1"
}

Parameters

ParameterTypeRequiredDescription
coin_symbolstringYesToken symbol (e.g. PEPE, BTC, SOL). Case-insensitive.
contract_addressstringNoToken contract address. Improves on-chain analysis accuracy.
chain_idstringNoBlockchain chain ID. Defaults to 1 (Ethereum).
request_idstringNoCustom request ID for idempotency. Auto-generated if omitted.

Supported chain IDs

ChainID
Ethereum1
BSC56
Base8453
SolanaUse solana (RugCheck integration)

Response — 202 Accepted

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "coin_symbol": "PEPE",
  "poll_url": "/api/agent/550e8400-e29b-41d4-a716-446655440000",
  "message": "Analysis job accepted. Poll poll_url for results."
}

Error responses

400 — Missing required parameter

{
  "error": "Missing required parameter: coin_symbol is required."
}

429 — Too many concurrent analyses

{
  "error": "Too many concurrent analyses in progress. Please retry in a moment."
}

403 — Demo limit reached

{
  "error": "Demo limit reached. Integrate via CROO Agent Store for full access."
}

500 — Internal server error

{
  "error": "Internal server error",
  "status": "degraded"
}

Rate limits

TierLimit
Live demo2 calls per week per device
Production (CROO CAP)Pay-per-call ($0.02/call), no fixed limit

See Rate Limits & Pricing for details.

On this page