$LSO Holder Benefit

20% Off Everything

Hold 500,000 $LSO tokens in your Base wallet and get 20% off every query across all 31 LSO data services. No caps. Renews automatically every 7 days as long as you hold.

At a Glance

500K
$LSO tokens required
20%
Discount on all services
7 days
JWT validity period
31
Services covered

How It Works

1

Buy $LSO on Base

Purchase at least 500,000 $LSO tokens on Uniswap (Base mainnet). Contract: 0xC3C624A31FB43a5d4a5549C4965c50607dA96bA3. Make sure the tokens are in the same wallet you'll use to pay for services.

2

Sign a Verification Message

Sign the message LoneStarOracle discount verification with your wallet. In ethers.js:

const sig = await signer.signMessage("LoneStarOracle discount verification");
3

Get Your Discount JWT

Call the verification endpoint with your wallet and signature:

GET https://discount.lonestaroracle.xyz/discount
  ?wallet=0xYOUR_WALLET
  &sig=0xYOUR_SIGNATURE

You'll receive a JWT valid for 7 days. Store it securely in your agent's config.

4

Add Headers to Your Requests

Include two headers with every LSO service call:

X-LSO-Discount: <your_jwt>
X-LSO-Wallet: 0xYOUR_WALLET

The service will return a 402 with the discounted price (20% less). Pay that amount from the wallet you declared.

5

Renew Every 7 Days

Your JWT expires after 7 days. Repeat steps 2–3 to renew. Renewal checks your live $LSO balance — you must still hold 500,000+ tokens. If you've sold below the threshold, no new JWT is issued.

Important Rules

Same Wallet Rule: The wallet that holds $LSO must be the same wallet that pays for services. Your paying wallet is verified at settlement — if it doesn't match the JWT, no discount is applied. This cannot be worked around.

px402 / Privacy Pool: If you pay using px402 (PRXVT privacy pool), your payment is anonymous — we cannot verify your wallet or $LSO holdings. px402 payments do not receive the discount. Privacy and the discount are mutually exclusive. Choose one.

Example: Discounted MacroPulse Call

import requests
import json

headers = {
    "X-LSO-Discount": "eyJhbGciOiJIUzI1...",   # your JWT
    "X-LSO-Wallet":   "0xYOUR_WALLET_ADDRESS",
}

# First call returns 402 with discounted price ($0.04 instead of $0.05)
r = requests.get("https://macro.lonestaroracle.xyz/macro", headers=headers)
# ... handle x402 payment flow, pay $0.04 from your declared wallet
# Second call (after payment) returns full macro data

Discount by Service

The 20% discount applies to all 31 services. Example savings:

$0.04
MacroPulse (was $0.05)
$0.12
TokenScope (was $0.15)
$0.04
ContractCheck (was $0.05)
$1.60
Security Audit (was $2.00)

Need Help?

Join our Telegram community for support, announcements, and updates:

✈ Join t.me/lonestaroracle

Or email: jay@lonestaroracle.xyz