# x402 Multi-Chain Blockchain & Lighter Intelligence API

> Pay-per-call NEAR Protocol, Solana, Base blockchain data, and proprietary Lighter DEX intelligence. All endpoints accept x402 USDC micropayments on Solana or Base. No API keys, no signup — just attach a payment header.

This API serves real-time blockchain data across three chains (NEAR, Solana & Base) plus unique Lighter DEX market intelligence with 30 endpoints. Blockchain endpoints cost $0.001-$0.005 USDC. Lighter intelligence endpoints cost $0.01-$0.03 USDC (premium, unique data). Agents pay by including an X-PAYMENT header with a USDC transaction proof on Solana or Base.

## NEAR Protocol Endpoints (8)

- [Account Balance](https://ironflip.duckdns.org/api/near/account/{id}/balance): GET — Returns NEAR balance (total, staked, available). $0.001
- [Access Keys](https://ironflip.duckdns.org/api/near/account/{id}/keys): GET — Returns full and function-call access keys. $0.001
- [Transaction](https://ironflip.duckdns.org/api/near/tx/{hash}?sender_id={sender}): GET — Full transaction with receipts and actions. $0.001
- [Validators](https://ironflip.duckdns.org/api/near/validators): GET — Current validator set with stake and uptime. $0.002
- [Validator Detail](https://ironflip.duckdns.org/api/near/validators/{id}): GET — Single validator with uptime percentage. $0.001
- [Staking](https://ironflip.duckdns.org/api/near/account/{id}/staking): GET — Staking delegations across pools. $0.002
- [NFT Tokens](https://ironflip.duckdns.org/api/near/nft/{contract}/tokens): GET — NFTs with metadata on a contract. $0.002
- [DeFi Pools](https://ironflip.duckdns.org/api/near/defi/pools): GET — Ref Finance liquidity pools. $0.005

## Solana Endpoints (9)

- [SOL Balance](https://ironflip.duckdns.org/api/solana/account/{id}/balance): GET — SOL balance in lamports and SOL. $0.001
- [Account Info](https://ironflip.duckdns.org/api/solana/account/{id}/info): GET — Account metadata (owner, executable). $0.001
- [Token Holdings](https://ironflip.duckdns.org/api/solana/account/{id}/tokens): GET — All SPL tokens, USDC first. $0.002
- [Stake Accounts](https://ironflip.duckdns.org/api/solana/account/{id}/stakes): GET — Staking positions with validators. $0.002
- [Recent Transactions](https://ironflip.duckdns.org/api/solana/account/{id}/transactions): GET — Recent tx signatures. $0.002
- [Transaction Detail](https://ironflip.duckdns.org/api/solana/tx/{signature}): GET — Parsed tx with instructions and logs. $0.001
- [Validators](https://ironflip.duckdns.org/api/solana/validators): GET — Top 30 vote accounts by stake. $0.002
- [Token Prices](https://ironflip.duckdns.org/api/solana/tokens/prices): GET — SOL, USDC, JUP, JTO, BONK prices + 24h change. $0.002
- [Network Stats](https://ironflip.duckdns.org/api/solana/network/stats): GET — Epoch, TPS, supply. $0.002

## Base (Ethereum L2) Endpoints (7)

- [ETH Balance](https://ironflip.duckdns.org/api/base/account/{id}/balance): GET — ETH balance in wei and human-readable. $0.001
- [Account Info](https://ironflip.duckdns.org/api/base/account/{id}/info): GET — EOA vs contract, nonce, code size. $0.001
- [Token Balances](https://ironflip.duckdns.org/api/base/account/{id}/tokens): GET — ERC-20 balances (USDC, WETH, DAI, AERO, etc.). $0.002
- [Transaction](https://ironflip.duckdns.org/api/base/tx/{hash}): GET — Full tx with receipt, status, gas used. $0.001
- [Latest Block](https://ironflip.duckdns.org/api/base/block/latest): GET — Block number, timestamp, tx count, gas. $0.002
- [Gas Price](https://ironflip.duckdns.org/api/base/gas): GET — Current gas price in gwei. $0.001
- [Network Stats](https://ironflip.duckdns.org/api/base/network/stats): GET — Chain ID, block number, gas price. $0.002

## Lighter DEX Intelligence Endpoints (6) — Premium

Proprietary data from continuous collection (5-min granularity, 22+ days of history). This data is unique — no other API provides structured Lighter vs Hyperliquid spread/depth comparisons.

- [Current Spreads](${BASE_URL}/api/lighter/spreads/current): GET — Current bid-ask spreads for BTC/ETH/SOL/HYPE/LIT on both venues. $0.01
- [Spread History](${BASE_URL}/api/lighter/spreads/history?symbol=BTC&hours=24): GET — Historical spread timeseries, 5-min granularity, up to 7 days. $0.03
- [Current Depth](${BASE_URL}/api/lighter/depth/current): GET — Order book depth at 0.3% band, both exchanges, all markets. $0.01
- [Whale Positions](${BASE_URL}/api/lighter/whales): GET — Live whale positions, bias, PnL, net exposure. $0.02
- [Signal Scores](${BASE_URL}/api/lighter/signals): GET — Tiered signal wallet scores (S/A/B), performance metrics. $0.02
- [XLP LP Data](${BASE_URL}/api/lighter/xlp): GET — XLP experimental LP across 26 markets: collateral, volume, fees, PnL. $0.02

## Payment

- Protocol: [x402](https://x402.org) — HTTP 402 payment flow
- Accepted on: Solana mainnet OR Base (Ethereum L2)
- Token: USDC
- Solana pay-to: 91xx1zU7hV59fiYq9jzJtThzgHkzm1JRjtgeKK1TGwA7
- Base pay-to: 0x364839A584817393D347Aaf40D4f860EE40Fb884
- Facilitator: https://facilitator.x402endpoints.online

## Documentation

- [OpenAPI Spec](https://ironflip.duckdns.org/openapi.json): Full OpenAPI 3.1 specification
- [Agent Card](https://ironflip.duckdns.org/.well-known/agent-card.json): A2A agent discovery manifest
- [Analytics Dashboard](https://ironflip.duckdns.org/dashboard): Live usage stats

## Optional

- [Health Check](https://ironflip.duckdns.org/health): Service status
- [Analytics API](https://ironflip.duckdns.org/api/analytics/summary): JSON usage stats