AlphaStream API Documentation

Overview

AlphaStream provides AI-powered conviction scoring for tokens on the Base blockchain. Each request costs $0.01 USDC via the x402 v2 micropayment protocol. Payments are settled transparently on Base mainnet — no API keys, no monthly minimums, no signup required.

Base URL: https://alphastream.deleonanalytics.com
Protocol: x402 v2 (HTTP/402 Payment Required)
Network: Base Mainnet (Chain ID 8453)
Payment Token: USDC
Recipient: 0x1804c8AB1F12E6bbf3894d4083f33e07309d1f38

Endpoints

GET /health

Service health check. Returns status, version, and timestamp. No payment required.

Example

curl https://alphastream.deleonanalytics.com/health

Response 200 OK

{
  "status": "healthy",
  "service": "AlphaStream",
  "version": "2.0.0",
  "protocol": "x402-v2",
  "timestamp": "2026-05-06T01:15:00.000Z"
}

POST /conviction $0.01 USDC required

Submit a Base token address for AI conviction analysis. Returns a conviction score (0–100), sentiment classification, and analysis summary.

Request Headers

Header	Required	Description
Content-Type	Yes	`application/json`
x402-payment	Yes	x402 v2 payment proof (see below)

Request Body

Field	Type	Required	Description
token	string	Yes	Base token contract address (0x...)
chain	string	No	Blockchain (default: `"base"`)

Example

curl -X POST https://alphastream.deleonanalytics.com/conviction \
  -H "Content-Type: application/json" \
  -H "x402-payment: {proof-data}" \
  -d '{"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'

Response 200 OK

{
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "chain": "base",
  "score": 78,
  "sentiment": "bullish",
  "analysis": "Score 78/100 based on on-chain metrics...",
  "conviction": {
    "score": 78,
    "sentiment": "bullish",
    "analysis": "...",
    "factors": ["volume", "liquidity", "social_sentiment", "holder_growth"]
  },
  "timestamp": "2026-05-06T01:15:00.000Z",
  "paid": "0.01"
}

GET /.well-known/x402

x402 protocol discovery endpoint. Returns available resources and ownership proofs for automated client negotiation.

Response 200 OK

{
  "version": 1,
  "resources": [
    "https://alphastream.deleonanalytics.com/conviction"
  ],
  "ownershipProofs": [
    "0x1804c8AB1F12E6bbf3894d4083f33e07309d1f38"
  ]
}

Error Responses

Status	Meaning
`400`	Missing or invalid parameters (e.g. no token address)
`402`	Payment required — include a valid x402 payment proof
`422`	Invalid payment proof — could not verify x402 transaction

Integration

Node.js / TypeScript

const response = await fetch('https://alphastream.deleonanalytics.com/conviction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x402-payment': paymentProof  // Generated by your x402 client
  },
  body: JSON.stringify({ token: '0x833589fCD6eD...', chain: 'base' })
});

const { score, sentiment, analysis } = await response.json();
console.log(`${token} conviction: ${score}/100 (${sentiment})`);

Python

import requests

response = requests.post(
    "https://alphastream.deleonanalytics.com/conviction",
    headers={
        "Content-Type": "application/json",
        "x402-payment": payment_proof  # Generated by your x402 client
    },
    json={"token": "0x833589fCD6eD...", "chain": "base"}
)

data = response.json()
print(f"Conviction: {data['score']}/100 — {data['sentiment']}")

Ready to automate?

Get a free API key with 50 requests/day. No credit card required.