# MemoryAPI — AI Agent Microservices > 37 specialized AI agents exposed as x402-gated HTTP endpoints. Pay per call in USDC on Base mainnet. 2 free calls/day/IP per endpoint. All endpoints return structured JSON. - Homepage: https://memoryapi.org - MCP endpoint: https://mcp.memoryapi.org/mcp - Pay-to address: 0x24FAcafEB49b4e3FACF0B3e69604A2F4640c9bf2 - Network: Base mainnet (eip155:8453) - Protocol: x402 (@x402/express 2.10.0) - Facilitator: https://x402.org/facilitator ## Weather > Real-time weather data for any location worldwide. Powered by Open-Meteo (no upstream API key required). ### GET https://weather.memoryapi.org/x402/weather/current Current weather conditions for any location. Price: $0.01 USDC ``` GET /x402/weather/current?location={location} Parameters: location string required City, region, or country (e.g. "Berlin", "Tokyo", "New York") Response: location.name string City name location.country string Country temperature_c number Temperature in Celsius feels_like_c number Apparent temperature in Celsius humidity_pct number Relative humidity % weather string Human-readable condition (e.g. "Partly cloudy") weather_code number WMO weather code wind_kmh number Wind speed km/h wind_direction_deg number Wind direction degrees wind_gusts_kmh number Wind gusts km/h precipitation_mm number Precipitation mm cloud_cover_pct number Cloud cover % pressure_hpa number Surface pressure hPa visibility_m number Visibility metres is_day boolean Daytime flag timezone string IANA timezone time string ISO-8601 observation time ``` ### GET https://weather.memoryapi.org/x402/weather/forecast Daily weather forecast up to 16 days. Price: $0.02 USDC ``` GET /x402/weather/forecast?location={location}&days={days} Parameters: location string required City, region, or country days integer optional Forecast days 1–16 (default 7) Response: location.name string timezone string days[].date string YYYY-MM-DD days[].weather string Condition description days[].temp_max_c number High temperature Celsius days[].temp_min_c number Low temperature Celsius days[].feels_max_c number Apparent high Celsius days[].feels_min_c number Apparent low Celsius days[].precipitation_mm number Total precipitation mm days[].precip_probability_pct number Max precipitation probability % days[].wind_max_kmh number Max wind speed km/h days[].gusts_max_kmh number Max wind gusts km/h days[].uv_index_max number UV index max days[].sunrise string ISO-8601 sunrise time days[].sunset string ISO-8601 sunset time ``` ### GET https://weather.memoryapi.org/x402/weather/hourly Hourly weather forecast up to 168 hours (7 days). Price: $0.02 USDC ``` GET /x402/weather/hourly?location={location}&hours={hours} Parameters: location string required City, region, or country hours integer optional Hours ahead 1–168 (default 24) Response: location.name string timezone string hours[].time string ISO-8601 hours[].temperature_c number hours[].feels_like_c number hours[].humidity_pct number hours[].weather string hours[].precipitation_mm number hours[].precip_probability_pct number hours[].wind_kmh number hours[].wind_direction_deg number hours[].cloud_cover_pct number hours[].visibility_m number ``` ### GET https://weather.memoryapi.org/x402/weather/history Historical daily weather for any location and date range (back to 1940, max 366 days per request). Price: $0.03 USDC ``` GET /x402/weather/history?location={location}&start_date={start_date}&end_date={end_date} Parameters: location string required City, region, or country start_date string required Start date YYYY-MM-DD (must be past) end_date string required End date YYYY-MM-DD (must be past, max 366 days from start) Response: location.name string timezone string days[].date string days[].weather string days[].temp_max_c number days[].temp_min_c number days[].precipitation_mm number days[].wind_max_kmh number ``` ### GET https://weather.memoryapi.org/x402/weather/alerts Active weather alerts for US locations via National Weather Service. Price: $0.01 USDC ``` GET /x402/weather/alerts?location={location} Parameters: location string required US city or state (e.g. "Chicago", "Miami, FL") Response: location.name string alert_count integer alerts[].event string Alert type (e.g. "Tornado Warning") alerts[].severity string Extreme | Severe | Moderate | Minor alerts[].urgency string Immediate | Expected | Future alerts[].headline string alerts[].description string (truncated to 500 chars) alerts[].effective string ISO-8601 alerts[].expires string ISO-8601 alerts[].area string Affected area description note: "NWS alerts available for US locations only" ``` ## Lottery > Powerball and Mega Millions lottery data. Sourced from NY Open Data (official government source). Results cached post-draw. ### GET https://lottery.memoryapi.org/x402/results Latest draw results for Powerball and Mega Millions. Price: $0.01 USDC ``` GET /x402/results?game={game} Parameters: game string optional "powerball" or "megamillions" (default: both) Response (powerball): game string "powerball" drawDate string YYYY-MM-DD numbers array 5 white ball numbers powerball integer Red ball number powerPlay integer Power Play multiplier jackpot string Jackpot amount or null nextDraw string Next draw date Response (megamillions): game string "megamillions" drawDate string numbers array 5 white ball numbers megaBall integer megaplier integer jackpot string or null ``` ### GET https://lottery.memoryapi.org/x402/history Historical draw results, up to 50 draws. Price: $0.02 USDC ``` GET /x402/history?game={game}&limit={limit} Parameters: game string optional "powerball" or "megamillions" limit integer optional Number of draws 1–50 (default 10) ``` ### GET https://lottery.memoryapi.org/x402/odds Full prize tier breakdown and expected value. Price: $0.01 USDC ``` GET /x402/odds?game={game} Parameters: game string optional "powerball" or "megamillions" ``` ### POST https://lottery.memoryapi.org/x402/check Check ticket numbers against latest draw. Price: $0.05 USDC ``` POST /x402/check Content-Type: application/json Body: game string required "powerball" or "megamillions" numbers array required 5 white ball numbers [int] special integer required Powerball or Mega Ball number ``` ### GET https://lottery.memoryapi.org/x402/quickpick Generate random lottery ticket(s). Price: $0.01 USDC ``` GET /x402/quickpick?game={game}&count={count} Parameters: game string optional "powerball" or "megamillions" (default: powerball) count integer optional Tickets to generate 1–10 (default 1) ``` ## Research > Academic paper search and citation data. Sources: PubMed, arXiv, OpenAlex, Semantic Scholar. ### GET https://research.memoryapi.org/x402/research/pubmed Search PubMed biomedical literature. Price: $0.02 USDC ``` GET /x402/research/pubmed?query={query}&limit={limit} Parameters: query string required Search query limit integer optional Results 1–20 (default 10) Response: results[].pmid string results[].title string results[].authors array results[].journal string results[].year integer results[].abstract string results[].doi string results[].url string ``` ### GET https://research.memoryapi.org/x402/research/arxiv Search arXiv preprints. Price: $0.02 USDC ``` GET /x402/research/arxiv?query={query}&limit={limit}&category={category} Parameters: query string required Search query limit integer optional Results 1–20 (default 10) category string optional arXiv category (e.g. "cs.AI", "physics", "q-bio") ``` ### GET https://research.memoryapi.org/x402/research/citations Citation count and reference data for a paper. Price: $0.02 USDC ``` GET /x402/research/citations?doi={doi} Parameters: doi string required Paper DOI (e.g. "10.1038/nature12373") ``` ## Biomedical > Drug, gene, protein, and clinical compound data. Sources: PubChem, UniProt, DrugBank, FDA. ### GET https://bio.memoryapi.org/x402/bio/compound Drug/compound information by name or identifier. Price: $0.02 USDC ``` GET /x402/bio/compound?name={name} Parameters: name string required Drug or compound name (e.g. "aspirin", "ibuprofen") Response: name string formula string molecular_weight number description string synonyms array cid integer PubChem CID ``` ### GET https://bio.memoryapi.org/x402/bio/gene Gene information by symbol or ID. Price: $0.02 USDC ``` GET /x402/bio/gene?symbol={symbol}&organism={organism} Parameters: symbol string required Gene symbol (e.g. "BRCA1", "TP53") organism string optional Organism (default "human") ``` ### GET https://bio.memoryapi.org/x402/bio/druginfo Clinical drug information, interactions, and indications. Price: $0.03 USDC ``` GET /x402/bio/druginfo?name={name} Parameters: name string required Drug name ``` ## Wallet > Ethereum/Base wallet portfolio and activity data. Powered by Alchemy. ### GET https://wallet.memoryapi.org/x402/wallet/portfolio Token portfolio for any EVM wallet address. Price: $0.02 USDC ``` GET /x402/wallet/portfolio?address={address}&chain={chain} Parameters: address string required EVM wallet address (0x...) chain string optional "base" or "eth" (default "base") Response: address string chain string totalUsd number Total portfolio value USD nativeBalance.symbol string nativeBalance.amount number nativeBalance.usd number tokens[].symbol string tokens[].name string tokens[].balance number tokens[].priceUsd number tokens[].valueUsd number ``` ### GET https://wallet.memoryapi.org/x402/wallet/activity Recent transaction activity for a wallet. Price: $0.02 USDC ``` GET /x402/wallet/activity?address={address}&chain={chain}&limit={limit} Parameters: address string required EVM wallet address (0x...) chain string optional "base" or "eth" (default "base") limit integer optional Transactions to return 1–50 (default 25) ``` ## Token > Token screening and safety analysis. Sources: GoPlus Security, DexScreener. ### GET https://token.memoryapi.org/x402/token/screen Token safety screening and risk analysis. Price: $0.03 USDC ``` GET /x402/token/screen?address={address}&chain={chain} Parameters: address string required Token contract address (0x...) chain string required Chain: "eth", "base", "bsc", "polygon", "arbitrum" Response: address string chain string riskScore number 0–100 (lower = safer) riskLevel string "low" | "medium" | "high" | "critical" flags array Risk flag descriptions raw.goplus object Full GoPlus response raw.dexscreener object DexScreener pair data ``` ## Shopping > Product search, comparison, and ranking across major retailers. ### POST https://shopping.memoryapi.org/x402/shop Search and compare products across retailers. Price: $0.50 USDC ``` POST /x402/shop Content-Type: application/json Body: query string required Product search query limit integer optional Results to return (default 10) minPrice number optional Minimum price USD maxPrice number optional Maximum price USD Response: results[].title string results[].price number results[].currency string results[].retailer string results[].url string results[].rating number results[].reviews integer ``` ## Validator > ERC-8004 agent validation. Runs test battery and submits ValidationResponse on-chain. ### POST https://validator.memoryapi.org/x402/validate Run validation test battery against an agent endpoint. Price: $15.00 USDC ``` POST /x402/validate Content-Type: application/json Body: agentId integer required ERC-8004 agent ID endpoint string required Agent endpoint URL to validate Response: agentId integer score integer 0–100 passed boolean tags array ["reliability", "accuracy", "x402", "safety"] txHash string On-chain ValidationResponse transaction breakdown object Per-test scores ``` ### GET https://validator.memoryapi.org/x402/score/:agentId Look up ERC-8004 reputation score for an agent. Price: $0.05 USDC ``` GET /x402/score/{agentId} Parameters: agentId integer required ERC-8004 agent ID (path parameter) Response: agentId integer score number 0–100 feedback integer Total feedback count ``` ## Notify > Deliver notifications via Telegram or webhook. Useful for agent-to-human alerting. ### POST https://notify.memoryapi.org/x402/notify/telegram Send a Telegram message to any chat ID. Price: $0.001 USDC ``` POST /x402/notify/telegram Content-Type: application/json Body: chat_id string required Telegram chat_id (user, group, or channel) message string required Message text (max 4096 chars) parse_mode string optional "Markdown", "MarkdownV2", or "HTML" Response: success boolean message_id integer chat_id integer ``` ### POST https://notify.memoryapi.org/x402/notify/webhook POST a JSON payload to any public HTTPS webhook URL. Price: $0.002 USDC ``` POST /x402/notify/webhook Content-Type: application/json Body: url string required Target HTTPS URL (public only, no localhost or private IPs) payload object required JSON body to POST headers object optional Extra HTTP headers Response: success boolean statusCode integer responseBody string ``` ## Intelligence > Market intelligence, provider recommendations, and competitive analysis. ### GET https://intel.memoryapi.org/x402/intel/providers Provider recommendations for a given capability or service category. Price: $0.05 USDC ``` GET /x402/intel/providers?category={category}&limit={limit} Parameters: category string required Service category (e.g. "image-generation", "translation", "search") limit integer optional Results to return (default 10) ``` ### GET https://intel.memoryapi.org/x402/intel/recommend Ranked service recommendations for an agent use case. Price: $0.05 USDC ``` GET /x402/intel/recommend?use_case={use_case} Parameters: use_case string required Natural language description of what the agent needs ```