EN | DE

Simple, per-query pricing

Free tier for exploration. Pay only for premium data — no subscriptions, no accounts.

No signup
No API key
Pay per query

Powered by x402 — HTTP-native micropayments on Solana

Discoverable by AI agents and MCP clients via the x402 Bazaar registry

Free

Free Tier

No payment, no signup required

GET /api/items

Latest publications — headline, lead, image, classification

GET /api/item/{slug}

Single item teaser — pay to unlock full body and key facts

GET /api/semantic-search

Semantic search across all items (limit 50 results)

GET /api/rag-context

RAG context for LLM pipelines (max 2000 tokens)

Try it now: 
# List items
curl https://state-of.biz/api/items?per_page=3

# Semantic search
curl "https://state-of.biz/api/semantic-search?q=inflation&limit=5"

Rate limit: 60 requests/minute

Tier Pricing

1 SOL = 1,000,000 credits

1 Metadata
1 credits
$0.00001 USDC
/institutions /feed-status
2 Structured Data
10 credits
$0.0001 USDC
/rates /sentiment /image
3 Semantic Objects
100 credits
$0.001 USDC
/semantic-search /rag-context /briefing /image-feed
4 Composite Reports
1,000 credits
$0.01 USDC
/cross-institution /weekly-digest

How it works

1

Send SOL to buy credits (1 SOL = 1,000,000 credits)

2

Include your wallet address in the request header

3

Credits are deducted per query — pay only for what you use

1

Call any premium endpoint — get a 402 response with payment requirements

2

Sign the payment payload with your Solana wallet (USDC)

3

Retry with the payment-signature header — get your data

Wallet Address

Send SOL to this address to purchase credits:

3RenNv83puYmmGAjCW1MXVdeDHfg4fHo7zK8nMfF8FPP
View on Solscan

Quick Start

python 
import requests

# 1. Buy credits (send SOL first, then verify)
resp = requests.post("https://state-of.biz/api/credits/purchase", json={
    "wallet": "YOUR_WALLET_ADDRESS",
    "tx_signature": "YOUR_SOL_TX_SIGNATURE"
})

# 2. Query premium endpoints
data = requests.get("https://state-of.biz/api/premium/rates",
    headers={"X-Credits-Wallet": "YOUR_WALLET_ADDRESS"}
).json()

# 3. Check balance
balance = requests.get(
    "https://state-of.biz/api/credits/balance?wallet=YOUR_WALLET_ADDRESS"
).json()
bash 
# 1. Discover pricing (any premium endpoint)
curl -s -I https://state-of.biz/api/premium/rates

# Response: 402 Payment Required
# payment-required: eyJzY2hlbWUiOi4uLn0=  (Base64 JSON)
# X-Credits-Cost: 10
# X-Wallet: 3RenNv83puYmmGAjCW1MXVdeDHfg4fHo7zK8nMfF8FPP

# 2. Decode requirements, sign with your wallet
# (x402-compatible clients handle this automatically)

# 3. Retry with payment signature
curl -s https://state-of.biz/api/premium/rates \
  -H "payment-signature: YOUR_BASE64_SIGNATURE"
Full API Documentation

FAQ

What is x402?
x402 is an open protocol for HTTP-native micropayments. When you request a premium endpoint without payment, you get a 402 Payment Required response with pricing and wallet information in the headers.
Credits or x402/USDC — which should I use?
Prepaid Credits are best for high-volume usage — buy in bulk with SOL, pay per query. x402/USDC is best for AI agents and one-off requests — no account needed, just sign and pay per request.
Which wallet do I need?
Any Solana wallet works (Phantom, Solflare, CLI). For credits: send SOL, then use your public key in the X-Credits-Wallet header. For x402: sign the payment payload and send the payment-signature header.
How do I check my balance?
GET /api/credits/balance?wallet=YOUR_WALLET_ADDRESS — returns your current credit balance.
How do AI agents discover these endpoints?
Any x402-compatible client or MCP agent can call a premium endpoint, read the 402 payment-required header, and automatically handle payment. The endpoints are discoverable via the x402 Bazaar registry.
Is there a free tier?
Yes! Every endpoint returns teaser content for free — headline, lead, image, and classification. No payment, no signup, 60 req/min. Pay per query to unlock the full analysis: body sections, key facts, and structured data.
All payments are verifiable on-chain
No subscription required