Checking...

REAL8 Developer API

RESTful API services for the REAL8 ecosystem. Access real-time price data, SEP-10 authentication, cross-chain bridge, and testnet faucet.

Open Wallet Website stellar.toml
https://api.real8.org

📊 Price Data API

Get real-time REAL8 token prices. Prices are calculated using weighted averages of recent trades on the Stellar DEX, cached for 5 minutes.

GET /prices Get all asset prices

Response

{
  "REAL8": {
    "asset": "REAL8",
    "price": 0.0329844,
    "priceInUSD": 0.1569177,
    "lastUpdate": "2025-12-31T20:48:02.516Z",
    "source": "trade"
  },
  "REAL8_USDC": {
    "asset": "REAL8",
    "price": 0.0070223,
    "priceInUSD": 0.0070223,
    "lastUpdate": "2025-12-31T20:48:02.634Z",
    "source": "trade"
  },
  "XLM": {
    "asset": "XLM",
    "price": 1,
    "priceInUSD": 0.4757,
    "lastUpdate": "2025-12-31T20:48:02.634Z",
    "source": "trade"
  }
}
cURL 
curl -s https://api.real8.org/prices

Try it

/prices
GET /prices/{asset} Get price for specific asset

Path Parameters

Parameter Type Description
assetrequired string Asset code: REAL8, REAL8_USDC, or XLM
cURL 
curl -s https://api.real8.org/prices/REAL8_USDC

Try it

/prices/REAL8_USDC

🔐 Authentication (SEP-10)

Stellar SEP-10 Web Authentication. Get a challenge transaction, sign it with your secret key, and receive a JWT token for authenticated requests.

GET /auth Get authentication challenge

Query Parameters

Parameter Type Description
accountrequired string Stellar public key (G...)
home_domainoptional string Home domain for authentication (default: real8.org)

Response

{
  "transaction": "AAAAAgAAAAB...base64_xdr...",
  "network_passphrase": "Public Global Stellar Network ; September 2015"
}
cURL 
curl -s "https://api.real8.org/auth?account=GABC...YOUR_PUBLIC_KEY"
POST /auth Submit signed challenge for JWT token

Request Body

Field Type Description
transactionrequired string Signed challenge transaction (base64 XDR)

Response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
cURL 
curl -X POST https://api.real8.org/auth \
  -H "Content-Type: application/json" \
  -d '{"transaction": "AAAAAgAAAAB...signed_xdr..."}'

🌉 Cross-Chain Bridge

Bridge REAL8 tokens between Stellar and EVM chains (BSC, Base, Optimism). Lock tokens on one chain, receive wrapped tokens on another.

GET /bridge/reserves Get bridge reserve balances

Response

{
  "stellar_locked": 888.0,
  "bsc_minted": 988.0,
  "base_minted": 100.0,
  "optimism_minted": 100.0,
  "solana_minted": 0,
  "peg_ratio": 1.0,
  "peg_healthy": true
}

Try it

/bridge/reserves
GET /bridge/health Bridge service health check

Try it

/bridge/health

🚰 Testnet Faucet

Claim free testnet REAL8 tokens for development and testing. Each address can claim 10,000 tokens once. Requires a REAL8 trustline on Stellar testnet.

GET /faucet/status Get faucet status and statistics

Response

{
  "status": "operational",
  "totalClaims": 42,
  "tokensPerClaim": 10000,
  "network": "testnet",
  "issuer": "GA2ZL55BWAKNCERJTYIKNQ27BD6BPOSZMZXQUMXUUKSZDF4A5GZFZUI7"
}

Try it

/faucet/status
GET /faucet/check/{address} Check if address can claim tokens

Path Parameters

Parameter Type Description
addressrequired string Stellar testnet public key (G...)

Response

{
  "canClaim": true,
  "hasTrustline": true,
  "alreadyClaimed": false
}
POST /faucet/claim Claim 10,000 testnet REAL8 tokens

Request Body

Field Type Description
addressrequired string Stellar testnet public key with REAL8 trustline

Success Response

{
  "success": true,
  "amount": 10000,
  "txHash": "abc123...def456"
}
cURL 
curl -X POST https://api.real8.org/faucet/claim \
  -H "Content-Type: application/json" \
  -d '{"address": "GABC...YOUR_TESTNET_ADDRESS"}'

🎁 Airdrop

Register for the REAL8 token airdrop. Receive 500 wREAL8 across 5 chains (100 per chain).

POST /airdrop/register Register for airdrop

Request Body

Field Type Description
emailrequired string Email address for notifications
stellarAddressrequired string Stellar public key (G...)
languageoptional string "en" or "es" (default: "en")

Success Response

{
  "success": true,
  "message": "Registration successful. Check your email for instructions."
}
GET /airdrop/registration-stats Get registration statistics

Try it

/airdrop/registration-stats

🌐 Network Information

⭐ Stellar Mainnet

  • Network: Public
  • Asset Code: REAL8
  • Issuer:
    GBVYYQ7XXRZW6ZCNNCL2X2THNPQ6IM4O47HAA25JTAG7Z3CXJCQ3W4CD
  • Home Domain: real8.org

🧪 Stellar Testnet

  • Network: Testnet
  • Asset Code: REAL8
  • Issuer:
    GA2ZL55BWAKNCERJTYIKNQ27BD6BPOSZMZXQUMXUUKSZDF4A5GZFZUI7
  • Faucet: 10,000 REAL8/address

🔗 BSC (BNB Smart Chain)

  • Token: wREAL8 (BEP-20)
  • Contract:
    0x34445f2cbA3964b5E814dB419F2beF12420A4C49
  • Explorer: BscScan

🔵 Base

  • Token: wREAL8 (ERC-20)
  • Contract:
    0x9f1605a496FD56A728bbd088Cf2Ecade4d40129c
  • Explorer: BaseScan

🔴 Optimism

  • Token: wREAL8 (ERC-20)
  • Contract:
    0x34445f2cbA3964b5E814dB419F2beF12420A4C49
  • Explorer: Optimism Etherscan

🟣 Solana

  • Token: wREAL8 (SPL)
  • Mint:
    2wy52bRjFd9dsNDF92GgVWVHpEBn3h9pT5j9CZKFDsu4
  • Explorer: Solscan