# Obol

> Verified blockchain data, paid per request with USDC on Base.

Obol validates data correctness and query efficiency before publishing a paid resource.

## Paid resources
- Base address snapshot — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/base/address-snapshot?address={evm_address}
- Returns ETH, canonical Base USDC, observed block/time, and two-provider consistency metadata.
- Base network status — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/base/network-status
- Parameterless. After payment, returns Base chain identity and one common block number, hash, time, and agreement metadata reconciled against two pre-probed distinct-operator endpoints.
- Multi-chain EVM address snapshot — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/evm/address-snapshot?chain_id={eip155_chain_id}&address={evm_address}
- After payment, returns a native-currency balance reconciled at one common block against two pre-probed distinct-operator endpoints. chain_id defaults to 8453; only chains in the locally probed registry are accepted.
- Sanctions address screening — 0.005 USDC via x402
- GET https://obol.danieldutoit.net/v1/sanctions/address-screening?address={blockchain_address}
- Exact-address lookup against public-source EU, OFAC, and UK wallet observations. Returns source and observation metadata without entity names. Informational only; not legal advice.
- Kraken candles — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/markets/kraken/candles?period={seconds}&base={asset}&quote={asset}&limit={1-100}
- Returns bounded, newest-first historical OHLCV observations for an exact period/base/quote tuple. Informational only; not investment advice.
- Kraken top-of-book exact snapshot — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/markets/kraken/orderbook-top?timestamp={unix_seconds}&base={asset}&quote={asset}
- Returns one exact historical best bid, best ask, and spread percentage, or an exact miss. Informational only; not investment advice.
- Multi-exchange top-of-book exact snapshot — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/markets/orderbook-top?exchange={BINANCEUS|COINBASE|CRYPTOCOM|GEMINI|KRAKEN|OKX}&timestamp={unix_seconds}&base={asset}&quote={asset}
- Returns one normalized historical best bid, best ask, and spread percentage snapshot, or an exact miss. Informational only; not investment advice.
- Multi-exchange candles — 0.001 USDC via x402
- GET https://obol.danieldutoit.net/v1/markets/candles?exchange={exchange}&period={seconds}&base={asset}&quote={asset}&limit={1-100}
- Returns bounded, newest-first multi-exchange historical OHLCV observations for an exact exchange/period/base/quote tuple. Informational only; not investment advice.
- Bitcoin address cluster — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/bitcoin/address-cluster?address={bitcoin_address}
- Returns one exact-address heuristic cluster assignment with derivation block and reason. A cluster is not proof of common ownership or identity.
- Bitcoin Cash address cluster — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/bitcoin-cash/address-cluster?address={bitcoin_cash_address}
- Returns one exact-address heuristic cluster assignment with derivation block and reason. A cluster is not proof of common ownership or identity.
- Dogecoin address cluster — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/dogecoin/address-cluster?address={dogecoin_address}
- Returns one exact-address heuristic cluster assignment with derivation block and reason. A cluster is not proof of common ownership or identity.
- Litecoin address cluster — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/litecoin/address-cluster?address={litecoin_address}
- Returns one exact-address heuristic cluster assignment with derivation block and reason. A cluster is not proof of common ownership or identity.
- Cardano transaction — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/cardano/transaction?hash={64_character_hex_transaction_hash}
- Returns at most one exact-hash Cardano mainnet transaction with bounded scalar transaction and block fields.
- Cardano stake rewards — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/cardano/stake-rewards?stake_address={cardano_mainnet_stake_address}&reward_type={reward_type}&earned_epoch_min={epoch}&earned_epoch_max={epoch}
- Returns up to 100 newest reward rows for one exact stake address and reward type over an earned-epoch range of at most 1,000.
- Solana transaction — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/solana/transaction?signature={canonical_base58_signature}&slot={canonical_nonnegative_integer}
- Returns at most one exact signature-and-slot Solana mainnet transaction with bounded public-chain scalar fields and no account keys.
- XRP transaction — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/xrp/transaction?transaction_hash={64_character_hex_hash}&block_number={ledger_number}&tx_index={transaction_index}
- Returns at most one exact XRP mainnet transaction with bounded public-chain scalar fields and no raw metadata.
- Ethereum complex flow — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/ethereum/complex-flow?from_address={evm_address}&to_address={evm_address}&asset={evm_address}&block_number_min={block}&block_number_max={block}
- Returns up to 100 newest aggregate flow observations for one exact address pair and asset over at most 100,000 blocks.
- Arbitrum token transfers — 0.003 USDC via x402
- GET https://obol.danieldutoit.net/v1/arbitrum/token-transfers?asset={evm_address}&block_number_min={block}&block_number_max={block}
- Returns up to 100 newest public token transfers for one exact asset over at most 100,000 blocks.
- Hit-conditional address labels — 0.001 USDC on known hits; exact misses free
- GET https://obol.danieldutoit.net/v1/address-labels?chain={ethereum_bitcoin_or_tron}&address={address}
- Checks an exact Ethereum, Bitcoin, or Tron address before payment. Misses return matched:false and charged:false; known hits receive an x402 challenge and a bounded paid label response.

## Public interfaces
- [API reference](https://obol.danieldutoit.net/docs)
- [OpenAPI 3.1](https://obol.danieldutoit.net/openapi.json)
- [x402 discovery](https://obol.danieldutoit.net/.well-known/x402)
- [x402 JSON manifest](https://obol.danieldutoit.net/.well-known/x402.json)
- [A2A agent card](https://obol.danieldutoit.net/.well-known/agent-card.json)
- [Health](https://obol.danieldutoit.net/health)