Back to Home

API Documentation

Complete reference for the AlphaStream conviction scoring API.

Base URL

https://alphastream.deleonanalytics.com/api

Authentication

AlphaStream uses x402 protocol for payment and authentication. Include your API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Endpoints

Get Conviction Score

POST /conviction

Returns an AI-powered conviction score (0-100) for a given token on Base.

Request Parameters

Parameter	Type	Required	Description
`token_address`	string	Yes	Contract address of the token
`chain`	string	Yes	Chain identifier (currently only "base")

Example Request

curl -X POST https://alphastream.deleonanalytics.com/api/conviction \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "token_address": "0x...",
    "chain": "base"
  }'

Example Response

{
  "token": "0x...",
  "conviction_score": 87,
  "sentiment": 92,
  "momentum": 78,
  "volume": 85,
  "timestamp": "2024-01-15T10:30:00Z"
}

Response Fields

Field	Type	Description
`token`	string	Token contract address
`conviction_score`	number	Overall conviction score (0-100)
`sentiment`	number	Sentiment analysis score (0-100)
`momentum`	number	Price momentum score (0-100)
`volume`	number	Volume analysis score (0-100)
`timestamp`	string	ISO 8601 timestamp of the analysis

Pricing

AlphaStream operates on a pay-per-request model using the x402 protocol.

$0.01 USDC per request
No minimums or monthly fees
Failed requests are not charged
First request is free

Error Codes

Code	Description
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid API key
`402`	Payment Required - Insufficient funds
`404`	Not Found - Token not found on chain
`500`	Internal Server Error

Need Help?
Join our Discord community or email us at [email protected]