# DopamineDesk AI Data Marketplace
Data marketplace with 43 billable tools and 86 total catalog entries for autonomous AI agents, Claude MCP, LangChain, CrewAI, and AutoGen.

## Payment Protocol
We use x402 v2 exact payments through the PayAI facilitator on Base mainnet. Billable operational endpoints return a PAYMENT-REQUIRED challenge. A standard x402 client signs it and retries with PAYMENT-SIGNATURE; successful settlement is returned in PAYMENT-RESPONSE. Preview-only fixtures reject payment. A legacy confirmed-transaction fallback remains available for existing clients.
Wallet: 0x7C69323FC27E1CA39bed9822d9D74c9A22618eDC

## Endpoints by Category

### Financial Data (9 endpoints)
- GET /api/v1/candles : Fetch recent cryptocurrency USD price observations from CoinGecko on each request. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: CoinGecko market chart API; tags: finance, crypto, coingecko, market-data, price-history]
  Example: "Get the recent USD price history for bitcoin."
- GET /api/v1/stock_quotes : Fetch the current or latest available market quote, daily OHLC values, and volume for a ticker from Yahoo Finance's chart feed. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: Yahoo Finance chart API; tags: finance, stocks, real-time, quotes, market-data]
  Example: "What is the current price and bid-ask spread for MSFT?"
- GET /api/v1/options_chain : Fetch comprehensive options chain data including all strikes, expirations, greeks, and implied volatility for a given underlying asset. (0.15 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: finance, options, derivatives, greeks, volatility]
  Example: "Get the options chain for TSLA expiring next week, including the Greeks."
- GET /api/v1/sec_edgar_filings : Retrieve official recent SEC filing metadata and primary-document links for a public-company ticker. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: SEC EDGAR submissions API; tags: finance, regulatory, filings, SEC, fundamentals]
  Example: "Find the latest 10-Q filing for NVDA and give me the link."
- GET /api/v1/earnings_calendar : Access upcoming corporate earnings call dates, estimated EPS, revenue estimates, and historic surprise data. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: finance, earnings, calendar, equities, events]
  Example: "What companies are reporting earnings tomorrow?"
- GET /api/v1/insider_trades : Retrieve official recent SEC Forms 3, 4, and 5 filing metadata and links. Transaction amounts are not parsed. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: SEC EDGAR submissions API; tags: finance, insider, filings, alpha, stocks]
  Example: "Show me recent insider buying for AMZN."
- GET /api/v1/fx_rates : Fetch current reference foreign-exchange rates for a base currency, optionally filtered to target currencies. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: ExchangeRate-API open endpoint; tags: finance, forex, fx, currencies, exchange-rates]
  Example: "What is the current EUR to USD exchange rate?"
- GET /api/v1/databento_orderflow : Deep L3 market-by-order (MBO) data and block trade tape to analyze institutional positioning and liquidity imbalances. (0.25 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: finance, orderflow, L3, market-depth, alpha, trading]
  Example: "Check for any large block trades on SPY in the last 15 minutes."
- GET /api/v1/company_funding : Returns recent venture capital funding rounds, investor details, and valuation data for private companies. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: startups, vc, funding, business]
  Example: "Get the latest funding info for OpenAI."

### Crypto & DeFi (12 endpoints)
- GET /api/v1/signals : Preview-only historical response fixture. The packaged signal rows do not have sufficient source provenance for sale. (0.20 USDC) [mode: sample; availability: preview_only; billable: false; source: unverified local response fixture; tags: crypto, signals, alpha, trading, quant]
  Example: "Give me the current trading signals for Ethereum."
- GET /api/v1/token_audit : Fetch current automated token-risk fields from GoPlus for a supported EVM contract. These third-party signals are not a guarantee of safety. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: GoPlus Token Security API; tags: crypto, security, audit, smart-contract, defi]
  Example: "Run an audit on this new token contract 0xabc... to see if it's a honeypot."
- GET /api/v1/whale_alerts : Monitor massive on-chain transfers of native assets and stablecoins entering or leaving centralized exchanges. (0.15 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: crypto, whales, on-chain, transfers, alpha]
  Example: "Show me any Bitcoin transfers over 10M dollars in the last hour."
- GET /api/v1/dex_launches : Fetch DexScreener's latest token-profile discovery feed. Entries are discovery signals, not verified launch timestamps. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: DexScreener latest token profiles; tags: crypto, dex, defi, liquidity, new-pairs]
  Example: "List the newest token pairs launched on Raydium in the last 10 minutes."
- GET /api/v1/nft_floor_prices : Fetch current NFT collection floor price, market cap, 24-hour volume, supply, and owner-count fields from CoinGecko. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: CoinGecko NFT API; tags: crypto, nft, floor-price, collectibles, web3]
  Example: "What is the current floor price for Bored Ape Yacht Club?"
- GET /api/v1/gas_oracle : Read the current eth_gasPrice value from a supported public Base, Ethereum, or Arbitrum JSON-RPC endpoint. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: public EVM JSON-RPC; tags: crypto, gas, fees, evm, optimization]
  Example: "What are the current gas prices on Ethereum?"
- GET /api/v1/pool_liquidity : Fetch live pair price, liquidity, volume, and price-change fields for a DEX pool address from DexScreener. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: DexScreener pair API; tags: crypto, defi, liquidity, amm, dex]
  Example: "How much liquidity is in the USDC-ETH 0.05% pool on Uniswap V3?"
- GET /api/v1/wallet_portfolio : Read native ETH and official USDC balances for a Base, Ethereum, or Arbitrum wallet, with an estimated ETH USD value. This is not a complete token or NFT portfolio. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: public EVM JSON-RPC and CoinGecko; tags: crypto, portfolio, wallet, balances, web3]
  Example: "Show me the token holdings for vitalik.eth."
- GET /api/v1/solana_pump_fun : Monitor real-time bonding curve status and memecoin creation events on Solana's Pump.fun protocol. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: crypto, solana, memecoins, pumpfun, alpha]
  Example: "List coins that just reached 90% of their bonding curve on Pump.fun."
- POST /api/v1/tx_simulator : Run eth_call and eth_estimateGas against a supported public EVM RPC without signing or broadcasting a transaction. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: public EVM JSON-RPC; tags: crypto, simulation, evm, security, developer]
  Example: "Simulate this Uniswap swap transaction to see if it reverts."
- POST /api/v1/token_metadata_bulk : Read ERC-20 symbol, name, decimals, and raw total supply for up to ten contract addresses using live eth_call requests. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: public EVM JSON-RPC; tags: crypto, metadata, tokens, defi, web3]
  Example: "Fetch the names and decimals for this list of 50 ERC-20 contract addresses."
- POST /api/v1/solana_route : Fetch a current Jupiter route quote for Solana token mints and a base-unit amount. This does not sign or broadcast a transaction. (0.03 USDC) [mode: live_source; availability: operational; billable: true; source: Jupiter Lite Quote API; tags: crypto, solana, dex, routing, arbitrage]
  Example: "Find the best route to swap 10 SOL for USDC."

### B2B & Leads (5 endpoints)
- GET /api/v1/leads : Query current business-registration records directly from official Chicago and San Francisco open-data APIs. Results include source-dataset and source-record links; this product does not claim private emails or buyer intent. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: City of Chicago Current Active Business Licenses API and DataSF Registered Business Locations API; tags: b2b, leads, sales, prospecting, marketing]
  Example: "Find 20 current auto-related business registrations in Chicago."
- POST /api/v1/enrich_leads : Resolve up to ten company-domain strings against Clearbit's live company autocomplete service. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: Clearbit Autocomplete API; tags: b2b, enrichment, emails, contact-info, sales]
  Example: "Find the work email and phone number for John Smith at Microsoft."
- GET /api/v1/github_emails : Preview-only response fixture. The packaged email records do not have sufficient source provenance for sale. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: unverified local response fixture; tags: b2b, github, developers, recruiting, emails]
  Example: "Get the email address for the GitHub user 'torvalds'."
- GET /api/v1/market_research : Fetch current top Hacker News story titles as a lightweight technology trend pulse. (0.15 USDC) [mode: live_source; availability: operational; billable: true; source: Hacker News Firebase API; tags: research, business, startups, market]
  Example: "Give me a market overview for the vertical farming industry."
- GET /api/v1/tech_stack_lookup : Fetch a public website with private-network blocking and report transparent heuristic technology signatures from markup and headers. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: live page and response-header fingerprinting; tags: developer, b2b, sales, technographics]
  Example: "What tech stack does stripe.com use?"

### Real Estate (6 endpoints)
- GET /api/v1/foreclosures : Preview-only response fixture. The packaged foreclosure records do not have sufficient source provenance for sale. (0.15 USDC) [mode: sample; availability: preview_only; billable: false; source: unverified local response fixture; tags: real estate, distressed, foreclosures, investing]
  Example: "Find recent foreclosures in Maricopa County, Arizona."
- GET /api/v1/property_zestimate : Provides an estimated market value and rent estimate for a specific residential property address. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: real estate, valuation, pricing, avm]
  Example: "What is the estimated value of 742 Evergreen Terrace, Springfield?"
- GET /api/v1/mortgage_rates : Fetch the latest weekly US national mortgage-rate observations from FRED. This is not a personalized lender quote. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: Federal Reserve Bank of St. Louis FRED; tags: real estate, finance, mortgage, interest rates]
  Example: "What are the current 30-year fixed mortgage rates in California?"
- GET /api/v1/rent_estimates : Returns average and median rent prices for apartments and single-family homes in a specified area. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: real estate, rentals, leasing, pricing]
  Example: "What is the average rent for a 2-bedroom apartment in Austin, TX?"
- GET /api/v1/property_tax_records : Accesses public county tax assessor records for property ownership, assessed value, and tax history. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: real estate, taxes, public records, ownership]
  Example: "Who owns 1600 Pennsylvania Ave NW, Washington, DC?"
- GET /api/v1/building_permits : Retrieves recently filed or approved building and construction permits for a specific municipality. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: real estate, construction, permits, development]
  Example: "Show me new commercial building permits in Seattle for the past week."

### E-Commerce (5 endpoints)
- GET /api/v1/amazon_bestsellers : Extracts the top-selling products in a specific Amazon category, including rank, price, and rating. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: ecommerce, amazon, retail, product research]
  Example: "What are the best-selling mechanical keyboards on Amazon right now?"
- GET /api/v1/etsy_keywords : Analyzes search volume, competition, and engagement metrics for search terms on Etsy. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: ecommerce, etsy, seo, keywords, handmade]
  Example: "Check Etsy search metrics for 'custom leather wallet'."
- GET /api/v1/shopify_store_lookup : Discovers tech stack, estimated traffic, top products, and theme details for a given Shopify storefront URL. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: ecommerce, shopify, competitor analysis, b2b]
  Example: "Analyze the Shopify store at allbirds.com."
- GET /api/v1/ebay_sold_items : Retrieves actual sold prices for items on eBay to determine true market value of used or collectible goods. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: ecommerce, ebay, pricing, market value, collectibles]
  Example: "What is the going rate for a used iPhone 13 Pro 128GB on eBay?"
- GET /api/v1/price_comparison : Compares the price of a specific UPC or EAN across major online retailers like Walmart, Target, and Best Buy. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: ecommerce, retail, arbitrage, price comparison]
  Example: "Compare prices for UPC 887276550756 across major stores."

### Government & Legal (6 endpoints)
- GET /api/v1/contracts : Query 100 packaged USAspending.gov contract-award records with a live source link for every award ID. (0.10 USDC) [mode: curated_snapshot; availability: operational; billable: true; source: USAspending.gov snapshot; all 100 award IDs API-verified on 2026-08-02; tags: government, contracts, b2b, sam.gov, spending]
  Example: "Find recent DoD contracts awarded to SpaceX."
- GET /api/v1/congressional_trades : Monitors STOCK Act disclosures to track stock, bond, and option trades made by US Senators and Representatives. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: government, finance, stocks, insider trading, politics]
  Example: "Show me recent stock purchases by Nancy Pelosi."
- GET /api/v1/fara_disclosures : Queries the FARA database for individuals and entities registered as lobbyists representing foreign principals. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: government, lobbying, legal, fara, foreign policy]
  Example: "Who is lobbying on behalf of the Saudi Arabian government?"
- GET /api/v1/lobbying_reports : Accesses House and Senate LDA (Lobbying Disclosure Act) reports indicating corporate spending on lobbying. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: government, lobbying, legal, lda, corporate spending]
  Example: "How much did Meta spend on lobbying in Q1 2026?"
- GET /api/v1/patents_search : Searches issued patents and published applications from the US Patent and Trademark Office by keyword or assignee. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: legal, intellectual property, patents, uspto, innovation]
  Example: "Find recent patents assigned to OpenAI."
- GET /api/v1/trademark_check : Searches TESS (Trademark Electronic Search System) for active, pending, or dead trademark registrations. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: legal, intellectual property, trademarks, uspto, branding]
  Example: "Check if the trademark 'DopamineDesk' is available."

### Social & Content (6 endpoints)
- GET /api/v1/twitter_search : Fetches recent tweets, replies, and engagement metrics for a given hashtag, keyword, or user profile. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: social, twitter, x, sentiment, trends]
  Example: "Get the latest tweets mentioning $TSLA."
- GET /api/v1/youtube_transcripts : Extracts full text transcripts and closed captions from public YouTube videos, including timestamps. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: social, youtube, video, transcription, content]
  Example: "Get the transcript for the YouTube video dQw4w9WgXcQ."
- GET /api/v1/tiktok_trends : Identifies currently trending audio tracks, hashtags, and viral challenges on TikTok by region. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: social, tiktok, trends, viral, creators]
  Example: "What are the top trending sounds on TikTok in the US right now?"
- GET /api/v1/hacker_news_top : Fetch current top-story metadata and discussion links from the official Hacker News Firebase API. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: Hacker News Firebase API; tags: social, tech, news, hacker news, ycombinator]
  Example: "What's on the front page of Hacker News?"
- GET /api/v1/producthunt_launches : Lists the top products launched on Product Hunt today, tracking upvotes, maker details, and product descriptions. (0.03 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: social, tech, startups, product hunt, launches]
  Example: "What are the top 3 products on Product Hunt today?"
- GET /api/v1/news_sentiment : Fetch recent Hacker News stories for a topic and apply a transparent keyword-lexicon sentiment score. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: Hacker News Algolia API plus deterministic lexicon; tags: news, sentiment analysis, finance, nlp, media]
  Example: "What is the news sentiment for Microsoft today?"

### Web Scraping (5 endpoints)
- GET /api/v1/serp : Retrieves top organic search results, snippets, and URLs for a specified keyword from major search engines. (0.02 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: search, serp, seo, google, bing]
  Example: "What are the top search results for 'best CRM software'?"
- POST /api/v1/scrape_md : Fetch a public HTTP(S) page with private-network blocking, remove boilerplate tags, and return bounded Markdown-like text. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: live public web fetch; tags: scrape, markdown, extraction, content, llm-ready]
  Example: "Get the text content of this article as markdown so I can summarize it."
- POST /api/v1/deep_scrape : Fetch a public HTTP(S) page with private-network blocking and return bounded Markdown-like content plus title, description, Open Graph image, status, and URL metadata. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: live public web fetch; tags: scrape, dynamic, javascript, spa, puppeteer]
  Example: "Scrape the dynamic pricing table from this React-based SaaS website."
- GET /api/v1/url_metadata : Fetch a public HTTP(S) page with private-network blocking and extract its title, description, Open Graph image, status, and content type. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: live public web fetch; tags: metadata, opengraph, seo, preview]
  Example: "Get the preview metadata for this link before I share it."
- GET /api/v1/rss_aggregator : Fetch a public RSS or Atom feed with private-network blocking and return bounded current entries. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: live RSS or Atom fetch; tags: rss, atom, news, feed, blog]
  Example: "Fetch the latest posts from Hacker News RSS."

### Security (5 endpoints)
- GET /api/v1/dns_whois : Resolve current DNS records and fetch public RDAP registration metadata for a domain. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: DNS resolution and RDAP.org; tags: dns, whois, domain, records, infrastructure]
  Example: "Check the WHOIS info and MX records for example.com."
- GET /api/v1/pwned_check : Checks if an email address or domain has been compromised in known public data breaches. (0.03 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: breach, pwned, email, security, compromise]
  Example: "Has john.doe@example.com been in any recent data breaches?"
- GET /api/v1/ip_reputation : Fetch public IP network, ASN, organization, location, and timezone context. This does not claim an abuse or threat score. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: IPWhoIs public API; tags: ip, network, asn, geolocation, infrastructure]
  Example: "Get public network and location context for 8.8.8.8."
- GET /api/v1/ssl_certificate : Inspect the certificate returned by a live TLS handshake, including validity, issuer, subject, authorization, and SHA-256 fingerprint. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: live TLS handshake; tags: ssl, tls, certificate, https, expiration]
  Example: "When does the SSL certificate for mybank.com expire?"
- POST /api/v1/code_audit : Scan supplied code with transparent deterministic rules for common secret, injection, shell, weak-hash, and Solidity risks. This is not a professional audit. (0.10 USDC) [mode: computed_service; availability: operational; billable: true; source: deterministic static rules; tags: sast, code, audit, vulnerability, secrets]
  Example: "Audit this Python function for security flaws."

### AI & ML (10 endpoints)
- GET /api/v1/ai_model_pricing : Fetch a current third-party aggregated model-pricing snapshot from LiteLLM. Buyers should verify final pricing with each provider. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: LiteLLM community pricing database; tags: llm, pricing, models, tokens, api]
  Example: "What is the current API cost for GPT-4o and Claude 3.5 Sonnet?"
- GET /api/v1/gpu_cloud_rates : Aggregates real-time hourly rental rates for GPUs (H100, A100, RTX 4090) across Lambda, RunPod, and AWS. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: gpu, cloud, compute, pricing, spot]
  Example: "Find the cheapest H100 instances available right now."
- POST /api/v1/summarize : Create a deterministic extractive summary by ranking and selecting sentences from the supplied text. (0.02 USDC) [mode: computed_service; availability: operational; billable: true; source: deterministic extractive summarizer; tags: nlp, summary, text, condense, reading]
  Example: "Summarize this 5-page report into 3 bullet points."
- POST /api/v1/extract_entities : Extract emails, URLs, money values, dates, and candidate capitalized phrases using transparent deterministic patterns. (0.02 USDC) [mode: computed_service; availability: operational; billable: true; source: deterministic pattern extractor; tags: ner, entities, nlp, extraction, data-mining]
  Example: "Extract the names of companies and people from this news article."
- POST /api/v1/embed : Create reproducible normalized 256-dimensional lexical feature-hash vectors. These are not neural semantic embeddings. (0.01 USDC) [mode: computed_service; availability: operational; billable: true; source: deterministic feature-hash vectorizer; tags: embeddings, vector, nlp, semantic, search]
  Example: "Get the vector embeddings for these three product descriptions."
- POST /api/v1/translate : Translate supplied text through MyMemory with source-language autodetection or an explicit language code. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: MyMemory Translation API; tags: translation, language, i18n, multilingual, nlp]
  Example: "Translate this customer support ticket from French to English."
- POST /api/v1/sentiment_bulk : Score up to 100 texts with a transparent deterministic positive and negative keyword lexicon. (0.05 USDC) [mode: computed_service; availability: operational; billable: true; source: deterministic keyword lexicon; tags: sentiment, emotion, reviews, nlp, batch]
  Example: "Analyze the sentiment of these 50 recent app store reviews."
- POST /api/v1/pdf_extract : Extracts text, tables, and form fields from PDF documents while preserving structural layout information. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: pdf, ocr, extraction, documents, tables]
  Example: "Extract the invoice details and line items from this PDF receipt."
- POST /api/v1/verify_emails : Validate email syntax and check live DNS MX records. MX presence does not prove an individual mailbox exists. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: syntax validation and live DNS MX lookup; tags: email, verification, deliverability, leads, marketing]
  Example: "Verify this list of 10 lead emails to remove bounces."
- POST /api/v1/form_submit : Uses AI-driven browser automation to navigate to a URL, map provided data to input fields, and submit forms. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: automation, forms, browser, rpa, headless]
  Example: "Submit a contact request on this vendor's website with my details."

### Generative AI (2 endpoints)
- POST /api/v1/generate_ad_copy : Generates high-converting ad copy variations tailored for Facebook, Google, or LinkedIn based on product details. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: marketing, ads, copywriting, generative, social]
  Example: "Write 3 variations of a Facebook ad for my new eco-friendly water bottle."
- POST /api/v1/competitor_analysis : Synthesizes data from the web to generate a strategic SWOT analysis and feature comparison against a competitor. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: business, strategy, competitors, swot, analysis]
  Example: "Generate a strategic analysis comparing our product (Stripe) to Adyen."

### Location & Travel (7 endpoints)
- GET /api/v1/flights : Preview-only response fixture. The packaged flight rows do not have sufficient source provenance for sale. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: unverified local response fixture; tags: travel, aviation, pricing, logistics]
  Example: "Find direct flights from JFK to LHR on Oct 12th."
- GET /api/v1/hotel_pricing : Retrieves current nightly rates, availability, and ratings for hotels in a specified location. (0.05 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: travel, accommodation, pricing, hospitality]
  Example: "What are the prices for 4-star hotels in Tokyo next weekend?"
- GET /api/v1/gas_prices : Provides average retail gasoline and diesel prices for specific zip codes or metropolitan areas. (0.02 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: automotive, energy, pricing, location]
  Example: "What is the average gas price in zip code 90210?"
- GET /api/v1/geocoding : Resolve a location or address query to current place candidates and coordinates through Open-Meteo. (0.01 USDC) [mode: live_source; availability: operational; billable: true; source: Open-Meteo Geocoding API; tags: maps, location, coordinates, gis]
  Example: "Get the coordinates for 1600 Amphitheatre Parkway."
- GET /api/v1/weather_forecast : Fetch current conditions and a one-to-seven-day forecast for a geocoded location from Open-Meteo. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: Open-Meteo Forecast API; tags: weather, meteorology, location]
  Example: "What is the weather forecast for Seattle today?"
- GET /api/v1/air_quality : Fetch current US AQI, European AQI, particulate, carbon monoxide, nitrogen dioxide, and ozone values for a geocoded location. (0.02 USDC) [mode: live_source; availability: operational; billable: true; source: Open-Meteo Air Quality API; tags: weather, environment, health, location]
  Example: "Check the air quality in Beijing right now."
- GET /api/v1/ev_chargers : Locates nearby Electric Vehicle charging stations, including connector types, power output, and live availability. (0.03 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: automotive, ev, location, energy]
  Example: "Find fast EV chargers near Austin, TX."

### Miscellaneous (3 endpoints)
- GET /api/v1/gigs : Preview-only response fixture. The packaged rows are business-license records, not verified Fiverr or freelance gigs. (0.10 USDC) [mode: sample; availability: preview_only; billable: false; source: misclassified local business-record fixture; tags: jobs, freelance, gigs, work]
  Example: "Find React native freelance gigs paying over $50/hr."
- GET /api/v1/github_trending : Fetch the most-starred repositories created during a selected recent period through the GitHub Search API. This is not GitHub's private trending algorithm. (0.10 USDC) [mode: live_source; availability: operational; billable: true; source: GitHub Search API; tags: developer, github, code, trends]
  Example: "What are the trending Rust repos today?"
- GET /api/v1/job_postings : Fetch and filter current remote job listings from Remote OK with source and apply links. (0.05 USDC) [mode: live_source; availability: operational; billable: true; source: Remote OK public API; tags: jobs, careers, hiring, recruitment]
  Example: "Find remote data engineer roles posted in the last 3 days."

### Platform (5 endpoints)
- GET /api/v1/health : Returns the operational status of the DopamineDesk API gateway and core services. (0.00 USDC) [mode: service; availability: operational; billable: false; source: marketplace runtime; tags: infrastructure, status, uptime, platform]
  Example: "Is the API currently up?"
- GET /api/v1/live_metrics : Provides current platform metrics such as requests per second, active agents, and average latency. (0.00 USDC) [mode: service; availability: operational; billable: false; source: marketplace runtime; tags: infrastructure, metrics, analytics, platform]
  Example: "What is the current platform request load?"
- GET /api/v1/catalog : Returns a comprehensive list of all available data endpoints on the marketplace, including pricing and schemas. (0.00 USDC) [mode: service; availability: operational; billable: false; source: canonical endpoint registry; tags: directory, catalog, meta, platform]
  Example: "List all available endpoints in the registry."
- POST /api/v1/batch : Executes multiple endpoint requests in a single batch operation for high-throughput data retrieval. (0.25 USDC) [mode: sample; availability: preview_only; billable: false; source: none; tags: infrastructure, batch, performance, platform]
  Example: "Run a batch query for 10 different stock tickers."
- POST /api/v1/create_agent_token : Exchange a verified $1.00 Base USDC payment for a hashed bearer token with persistent marketplace credit valid for 30 days. (1.00 USDC) [mode: payment_service; availability: operational; billable: true; source: verified Base USDC and Firestore credit ledger; tags: security, auth, agents, platform]
  Example: "Create a persistent marketplace credit token for my research agent."

See /openapi.json for full parameter schemas and example responses.