API Documentation

The Stratium Data API provides REST access to curated Solana wallet intelligence — wallet quality scores computed from on-chain FIFO P&L analysis, full profit/loss audit trails, and configurable portfolio backtesting. This guide covers authentication, rate limits, response conventions, and links to each product's endpoint reference.

API Products

Wallet Scores

Enriched wallet quality metrics and composite scores

PnL Analytics

FIFO P&L computation with full audit trail

Portfolio Backtest

Historical portfolio simulation and strategy comparison

Download OpenAPI SpecOpenAPI 3.0.1 — use with Cursor, Claude Code, or any OpenAPI-compatible tool

Authentication

All API requests require an API key passed via the X-API-Key header. Keys are issued after your access request is approved and scoped to your pricing tier.

curl "https://api.stratiumsol.com/v1/wallets/scored?limit=10" \
  -H "X-API-Key: sk_live_your_key_here"

const response = await fetch(
  "https://api.stratiumsol.com/v1/wallets/scored?limit=10",
  {
    headers: {
      "X-API-Key": process.env.STRATIUM_API_KEY!,
    },
  }
);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.stratiumsol.com/v1/wallets/scored",
    params={"limit": 10},
    headers={"X-API-Key": os.environ["STRATIUM_API_KEY"]},
)
data = response.json()

curl "https://api.stratiumsol.com/v1/wallets/scored?limit=10" \
  -H "X-API-Key: sk_live_your_key_here"

const response = await fetch(
  "https://api.stratiumsol.com/v1/wallets/scored?limit=10",
  {
    headers: {
      "X-API-Key": process.env.STRATIUM_API_KEY!,
    },
  }
);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.stratiumsol.com/v1/wallets/scored",
    params={"limit": 10},
    headers={"X-API-Key": os.environ["STRATIUM_API_KEY"]},
)
data = response.json()

curl "https://api.stratiumsol.com/v1/wallets/scored?limit=10" \
  -H "X-API-Key: sk_live_your_key_here"

const response = await fetch(
  "https://api.stratiumsol.com/v1/wallets/scored?limit=10",
  {
    headers: {
      "X-API-Key": process.env.STRATIUM_API_KEY!,
    },
  }
);
const data = await response.json();

import os
import requests

response = requests.get(
    "https://api.stratiumsol.com/v1/wallets/scored",
    params={"limit": 10},
    headers={"X-API-Key": os.environ["STRATIUM_API_KEY"]},
)
data = response.json()

Keep your API key secret. Do not expose it in client-side code, public repositories, or browser requests. Use environment variables and server-side proxies.

Base URL

https://api.stratiumsol.com/v1

All endpoints are prefixed with this base URL.

Response Format

All endpoints return JSON with a consistent envelope structure:

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 142,
    "offset": 0,
    "limit": 20,
    "cached": true,
    "cache_age_seconds": 45
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 12 seconds."
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 142,
    "offset": 0,
    "limit": 20,
    "cached": true,
    "cache_age_seconds": 45
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 12 seconds."
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

{
  "success": true,
  "data": { ... },
  "meta": {
    "total": 142,
    "offset": 0,
    "limit": 20,
    "cached": true,
    "cache_age_seconds": 45
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Retry after 12 seconds."
  },
  "timestamp": "2026-04-14T12:00:00Z"
}

Rate Limits

Rate limits are applied per API key using a sliding window. When exceeded, the API returns HTTP 429 with a Retry-After header indicating seconds until the next available request.

Tier Limits

Parameter	Type	Required	Default	Description
`Signal`	$99/mo	Optional	60 req/min	Wallet Scores API only
`Analytics`	$249/mo	Optional	120 req/min	Signal + PnL Analytics API
`Backtest`	$499/mo	Optional	120 req/min + 50 sim/day	Analytics + Portfolio Backtest API

HTTP Status Codes

Status Codes

Parameter	Type	Required	Default	Description
`200`	OK	Optional	—	Request succeeded
`400`	Bad Request	Optional	—	Invalid parameters or malformed request body
`401`	Unauthorized	Optional	—	Missing or invalid API key
`403`	Forbidden	Optional	—	API key lacks permission for this endpoint
`404`	Not Found	Optional	—	Resource does not exist
`429`	Rate Limited	Optional	—	Too many requests. Check Retry-After header.
`500`	Server Error	Optional	—	Internal error. Retry with exponential backoff.

Pricing

Signal

Wallet scoring and discovery data

$99/mo

Starting from. Pricing details on launch.

Wallet Scores API
Scored wallet search and filtering
SSE stream of new wallet scores
60 requests/minute
Email support

Get Early Access

Analytics

Full PnL computation and risk metrics

$249/mo

Starting from. Pricing details on launch.

Everything in Signal
PnL Analytics API
FIFO P&L with audit trail
Position tracking and chart data
120 requests/minute
Priority support

Get Early Access

Backtest

Portfolio simulation and strategy comparison

$499/mo

Starting from. Pricing details on launch.

Everything in Analytics
Portfolio Backtest API
Compare up to 10 strategies
50 simulations/day
120 requests/minute
Dedicated support

Get Early Access

Frequently Asked Questions

What data does the Stratium API provide?

The Stratium Data API exposes three products: Wallet Scores (enriched quality metrics for Solana wallets), PnL Analytics (FIFO-based profit/loss computation with full audit trail), and Portfolio Backtest (historical simulation of copy-trading portfolios). All data is derived from on-chain Solana transactions analyzed across 30+ DEX programs.

How is the API authenticated?

All requests require an API key passed via the X-API-Key header. Keys are issued after your access request is approved. Each key is scoped to a specific tier (Signal, Analytics, or Backtest) which determines available endpoints and rate limits.

What is the rate limit?

Rate limits depend on your pricing tier: Signal (60 requests/minute), Analytics (120 requests/minute), and Backtest (120 requests/minute plus 50 simulations per day). Limits use a sliding window. Exceeding the limit returns HTTP 429 with a Retry-After header.

Is there a free tier or trial?

We are evaluating a free tier with limited access to the Wallet Scores API. Early access members will be notified when trial access becomes available. Pricing is subject to change before public launch.

How fresh is the data?

Wallet scores are updated after each scoring run triggered by on-chain activity, typically within minutes. PnL data for tracked wallets is computed on demand and cached for 10 minutes. Historical backfill data is refreshed daily via a cron job at 22:00 UTC.

What Solana wallets are covered?

The API covers wallets that have been tracked and scored by Stratium's Alpha Forge discovery pipeline. This includes wallets detected via real-time DEX monitoring and PnL scan analysis. Not every Solana wallet has a score — only those that pass the observation threshold and quality filters.