# The Undesirables Oracle Terminal

> x402-enabled TCG and prediction market intelligence API. Pay per request in USDC on Base. No API keys, no accounts. 7 paid endpoints, 2 free endpoints, 370K+ card database.

Base URL: https://oracle.the-undesirables.com
Payment: USDC on Base (eip155:8453) via Coinbase CDP Facilitator
Merchant: 0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B
Contract: 0xa893648a701c03b14bf2fb767b72b2c55ed5c17a (Ethereum Mainnet ERC721)

## How to Call (x402 Protocol)
1. Send a standard GET request to any paid endpoint
2. Receive HTTP 402 with `Payment-Required` header (base64-encoded JSON)
3. Decode the header to get payment requirements (amount, payTo address, network)
4. Sign the USDC payment with your wallet on Base
5. Retry the request with a `Payment-Signature` header
6. Receive the JSON response

Install agentic wallet: $ npx skills add coinbase/agentic-wallet-skills
Discover all endpoints: GET https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant?payTo=0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B

## Free Endpoints
- [Search Cards](https://oracle.the-undesirables.com/api/v1/search?query=charizard): Search 370K+ TCG products across Pokemon, Magic, Yu-Gi-Oh, One Piece, and more. Query by card name, returns product_id, name, rarity, market_price, and price history.
- [Market Dashboard](https://oracle.the-undesirables.com/api/v1/market?game=Pokemon): Daily price snapshots for top cards by game. Returns the 25 highest-value cards with market prices, low/mid/high ranges, and price dates.

## Paid Endpoints — TCG Intelligence
- [Grade Card](https://oracle.the-undesirables.com/api/v1/grade) ($0.10 USDC): AI vision card grading engine. Analyzes centering, corners, edges, and surface to predict PSA and Beckett grades. Params: image_url (required), game (default: Pokemon).
- [Monte Carlo Simulate](https://oracle.the-undesirables.com/api/v1/simulate) ($0.015 USDC): Stochastic price simulation using Heston (vol-of-vol), Merton (jump-diffusion), or Kou (double-exponential jumps) models. Returns percentile bands (5th through 95th). Params: card_name, current_price (required), model, days, simulations.
- [Crypto Oracle](https://oracle.the-undesirables.com/api/v1/crypto-oracle) ($0.05 USDC): Fetches real-time NFT floor prices via Alchemy API and runs Heston Monte Carlo forecasting. Params: contract_address (required), network (default: eth-mainnet), days.
- [Coin History](https://oracle.the-undesirables.com/api/v1/coin-history) ($0.05 USDC): CoinGecko historical price data combined with stochastic forecast generation. Params: coin_id (required, e.g. "ethereum", "bitcoin"), days.

## Paid Endpoints — Prediction Market Arbitrage
- [Cross-Platform Arb](https://oracle.the-undesirables.com/api/v1/arb-cross) ($1.00 USDC): Finds price discrepancies between Polymarket and Kalshi for the same event using Gen3 NLI semantic matching. Returns events where platforms disagree on probability, sorted by edge percentage. Params: min_edge (default: 3.0).
- [Basket Arb](https://oracle.the-undesirables.com/api/v1/arb-basket) ($0.50 USDC): Multi-outcome arbitrage scanner. Identifies events where buying all NO outcomes costs less than the guaranteed payout, producing risk-free profit. No required params.
- [Weather Arb](https://oracle.the-undesirables.com/api/v1/arb-weather) ($0.25 USDC): Compares National Weather Service temperature forecasts against Kalshi temperature derivative contracts to find mispriced weather markets. No required params.

## Discovery
- [Agentic Market Index](https://api.cdp.coinbase.com/platform/v2/x402/discovery/merchant?payTo=0x642e8a7C289381f24f0395e0539f0bA41c74Cc1B): All indexed endpoints via Coinbase CDP
- [Swagger Docs](https://oracle.the-undesirables.com/docs): Interactive API documentation with schemas
- [Oracle Terminal UI](https://the-undesirables.com/terminal): Consumer-facing market intelligence dashboard
- [Full Documentation](https://the-undesirables.com/llms-full.txt): Expanded documentation with cURL examples and response schemas

## MCP Server (Local Install)
- [PyPI Package](https://pypi.org/project/undesirables-mcp-server/): pip install undesirables-mcp-server — 35+ local AI tools
- [GitLab Source](https://gitlab.com/meme-merchants/undesirables-mcp-server): Full source code, README, and documentation
- [GitHub Mirror](https://github.com/sailorpepe/undesirables-mcp-server): GitHub mirror of the source code

## Optional
- [ElizaOS Plugin](https://gitlab.com/meme-merchants/plugin-undesirables): ElizaOS plugin for adding Undesirables soul personality to any ElizaOS agent
- [mcp.so Listing](https://mcp.so): Listed on the largest MCP server directory
- [Etherscan Contract](https://etherscan.io/address/0xa893648a701c03b14bf2fb767b72b2c55ed5c17a): Smart contract on Ethereum Mainnet
- [Mint Page](https://scatter.art/the-undesirables): Scatter.art mint page
- [Website](https://the-undesirables.com): The Undesirables collection website
- [Docs](https://the-undesirables.com/docs): Architecture and documentation