REAL8 Developer API
RESTful API for the REAL8 ecosystem. Access real-time price data, cross-chain bridge reserves, authentication, and testnet faucet.
📊 Price Data
🔐 SEP-10 Auth
🌉 Cross-Chain Bridge
🚰 Testnet Faucet
🎁 Airdrop
https://api.real8.org
📡 API Endpoints
Price Data
▼
GET
/prices
All asset prices (REAL8, XLM, USDC, EURC). Cached 2 min. Use
?refresh=true to bypass cache.
GET
/prices/{asset}
Single asset price. Assets:
REAL8, REAL8_USDC, XLM
Authentication (SEP-10)
▼
GET
/auth
Service info (signing key, home domain, supported assets)
GET
/auth?account={G...}
Generate SEP-10 challenge transaction (XDR) for Stellar account
POST
/auth
Submit signed challenge to receive JWT token. Body:
{"transaction": "<signed_xdr>"}
Cross-Chain Bridge
▼
GET
/bridge/reserves
Live on-chain reserves across all chains (Stellar, BSC, Base, Optimism, Solana). Cached 60s.
GET
/bridge/health
Peg health check. Returns peg ratio (stellar_locked / total_wrapped), should be ≥ 1.0
GET
/bridge/stats
Bridge statistics: total requests, volume, requests by chain and status
GET
/bridge/quote?from_chain=stellar&to_chain=bsc&amount=1000
Get bridge quote: estimated fee, amount received, and processing time
GET
/bridge/status/{id}
Check status of a specific bridge request by ID
GET
/bridge/requests?address={G...}
List all bridge requests for a Stellar address
Testnet Faucet
▼
GET
/faucet/status
Faucet status: enabled flag, total claims count
GET
/faucet/check/{address}
Check if a testnet address can claim tokens (one claim per address)
POST
/faucet/claim
Claim 10,000 testnet REAL8 tokens. Body:
{"address": "G..."}
Airdrop
▼
POST
/airdrop/register
Register a Stellar address for the REAL8 airdrop
GET
/airdrop/registration-stats
Public registration statistics (total registrations, pending, processed)
Health & Status
▼
GET
/health
API health check (status, version, network, environment)
GET
/bridge/health
Bridge peg health (ratio, reserves, overcollateralization status)
💡 Examples
Get REAL8 price in USD
Fetch the current REAL8/USDC price from the Stellar SDEX orderbook.
curl -s https://api.real8.org/prices/REAL8_USDC | python3 -m json.tool
const res = await fetch('https://api.real8.org/prices/REAL8_USDC'); const data = await res.json(); console.log(`REAL8 price: $${data.REAL8_USDC.price}`);
import requests data = requests.get('https://api.real8.org/prices/REAL8_USDC').json() print(f"REAL8 price: ${data['REAL8_USDC']['price']}")
Response
{
"REAL8_USDC": {
"pair": "REAL8/USDC",
"price": 0.0142,
"source": "vwap",
"timestamp": "2026-03-23T07:00:00.000Z"
}
}
Get all prices at once
Returns REAL8, REAL8_USDC, and XLM prices in a single request. Prices are VWAP from recent SDEX trades, with orderbook mid-price as fallback.
curl -s https://api.real8.org/prices
const res = await fetch('https://api.real8.org/prices'); const { REAL8, REAL8_USDC, XLM } = await res.json(); console.log(`REAL8: ${REAL8.priceInUSD} USD (${REAL8.price} XLM)`); console.log(`XLM: ${XLM.priceInUSD} USD`);
Response
{
"REAL8": {
"pair": "REAL8/XLM",
"price": 0.0316,
"priceInUSD": 0.01422,
"source": "vwap"
},
"REAL8_USDC": {
"pair": "REAL8/USDC",
"price": 0.0142,
"source": "vwap"
},
"XLM": {
"pair": "XLM/USDC",
"price": 2.222,
"priceInUSD": 0.45,
"source": "vwap"
}
}
Check bridge reserves and peg ratio
Verify that cross-chain wREAL8 is fully backed by REAL8 locked on Stellar. Queries live on-chain balances.
# Check reserves across all chains curl -s https://api.real8.org/bridge/reserves # Check peg health (ratio should be >= 1.0) curl -s https://api.real8.org/bridge/health
const reserves = await fetch('https://api.real8.org/bridge/reserves') .then(r => r.json()); console.log(`Stellar locked: ${reserves.stellar.locked} REAL8`); console.log(`BSC supply: ${reserves.bsc.totalSupply} wREAL8`); console.log(`Peg ratio: ${reserves.peg_ratio}`);
Response (/bridge/reserves)
{
"stellar": { "locked": 1000000 },
"bsc": { "totalSupply": 100000 },
"base": { "totalSupply": 50000 },
"solana": { "totalSupply": 0 },
"peg_ratio": 6.67,
"cached_at": "2026-03-23T07:00:00.000Z"
}
Claim testnet REAL8 tokens
Get 10,000 free REAL8 tokens on Stellar testnet for development and testing. One claim per address. Requires a REAL8 trustline first.
# 1. Check if your address can claim curl -s https://api.real8.org/faucet/check/GABC...YOUR_TESTNET_ADDRESS # 2. Claim tokens curl -X POST https://api.real8.org/faucet/claim \ -H "Content-Type: application/json" \ -d '{"address": "GABC...YOUR_TESTNET_ADDRESS"}'
const address = 'GABC...YOUR_TESTNET_ADDRESS'; // Check eligibility const check = await fetch(`https://api.real8.org/faucet/check/${address}`) .then(r => r.json()); if (check.canClaim) { // Claim 10,000 testnet REAL8 const result = await fetch('https://api.real8.org/faucet/claim', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ address }) }).then(r => r.json()); console.log('Claimed!', result); }
Response
{
"success": true,
"message": "10000 testnet REAL8 sent",
"txHash": "abc123..."
}
Get a bridge quote
Estimate the cost and time for wrapping REAL8 (Stellar) to wREAL8 on another chain.
curl -s "https://api.real8.org/bridge/quote?from_chain=stellar&to_chain=bsc&amount=5000"
const params = new URLSearchParams({ from_chain: 'stellar', to_chain: 'bsc', amount: '5000' }); const quote = await fetch(`https://api.real8.org/bridge/quote?${params}`) .then(r => r.json()); console.log(`Fee: ${quote.fee} REAL8`); console.log(`You receive: ${quote.amount_out} wREAL8`);
🌐 Network Information
⭐ Stellar (Mainnet)
- Asset: REAL8 (credit_alphanum12)
- Issuer: GBVYYQ7XXRZW6ZCNNCL2X2THNPQ6IM4O47HAA25JTAG7Z3CXJCQ3W4CD
- Home Domain: real8.org
- Horizon: https://horizon.stellar.org
🧪 Stellar (Testnet)
- Asset: REAL8 (credit_alphanum12)
- Issuer: GA2ZL55BWAKNCERJTYIKNQ27BD6BPOSZMZXQUMXUUKSZDF4A5GZFZUI7
- Faucet: 10,000 REAL8 per address
- Horizon: https://horizon-testnet.stellar.org
🔗 Cross-Chain (wREAL8)
- BSC: wREAL8 (BEP-20)
- Base: wREAL8 (ERC-20)
- Optimism: wREAL8 (ERC-20)
- Solana: wREAL8 (SPL Token)
- Peg: 1:1 backed by locked REAL8 on Stellar