canonical: https://jentic.com/apis/mooncatcherwire.com/mooncatcherwire # Moon Catcher Wire REST API The Moon Catcher Wire REST API serves the stories on the Moon Catcher Wire crypto news board as read-only JSON, ordered by market impact with the strongest first. Each story carries its headline and drudge-style rewrite, summary, source domain, credibility, tickers, a sentiment score from -1 bearish to +1 bullish, an impact score from 0 to 1, and a breaking flag. Stories can be filtered by ticker, topic, recency in hours, or breaking status, and a topics listing returns the rules behind each topic slug. The board reflects the same editorial decisions as the website, and stories editors withhold are counted but not served. ## For AI agents Read the Moon Catcher Wire crypto news board by ticker, topic, or recency, with per-story sentiment, impact, credibility, and breaking flags. ## Scope Does not return token prices, place trades, or publish stories. Use for reading the Moon Catcher Wire crypto news board only. ## Capabilities - Pull current crypto news stories for a ticker such as BTC, ranked by market impact - Filter stories to a topic slug from the topics listing or to breaking stories only - Limit results to stories from the last N hours with since_hours - Read per-story sentiment, impact, credibility, and source domain scores - List every topic with its title, tickers, and the headline pattern it matches ## Use cases ### AI trading assistant that checks the news before answering An agent asked about a token's price move needs the current headlines behind it. Through Jentic the agent searches for 'get crypto news for a ticker', loads the Moon Catcher Wire stories operation with its input schema, and sends the ticker and a since_hours window. The mcw_ portal key is attached by your own Jentic One instance, and the agent gets back stories ranked by impact with sentiment scores it can cite. Example prompt: Call GET /stories with ticker BTC, since_hours 12, and limit 10, then summarise the three highest-impact stories with their sentiment ### Breaking-news alerts for a crypto desk A desk that watches for market-moving crypto news can poll the board for breaking stories only. The breaking_only filter returns stories flagged is_breaking, each with an impact score from 0 to 1 and the source domain, so an alerting job can forward only stories above a chosen impact threshold. Example prompt: Call GET /stories with breaking_only true and since_hours 1, and post any story with impact above 0.7 to the alerts channel ### Topic-level sentiment tracking Analysts tracking a theme, such as a regulatory topic or a token ecosystem, can read the topics listing to find its slug and tickers, then pull stories for that topic. Averaging the per-story sentiment scores gives a quick read of whether coverage is leaning bullish or bearish. Example prompt: Call GET /topics to find a topic slug, then call GET /stories with that topic and limit 60 and report the average sentiment ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/stories` | List stories by market impact | | GET | `/topics` | List the topic rules stories filter by | ## Key resources - **Stories** — Current board stories with headline, summary, tickers, sentiment, impact, credibility, and breaking flag - **Topics** — Topic slugs with titles, tickers, and the headline and summary pattern each matches ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 60 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 100 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 42 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 44 / 100 - **View full report:** https://jentic.com/apis/mooncatcherwire.com/mooncatcherwire/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring Moon Catcher Wire by hand means creating an mcw_ portal key, sending it as a bearer token, and knowing that topic filters must match a slug from the topics listing. Through Jentic you install once, import Moon Catcher Wire from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Both operations are reads, and filters like ticker and topic travel as query parameters rather than path segments, so rules bound which operations your agent may call, not which ticker it asks about. There is no write surface to exclude. - **Credential handling:** Your Moon Catcher Wire portal key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get crypto news for a ticker' or 'list news topics', and Jentic returns the matching Moon Catcher Wire operation with its input schema, including the ticker, topic, since_hours, and breaking_only parameters. ## Related APIs - **Crypto Vision News** — Crypto market data and news with AI briefs and summaries - **News API** — General news search across many publishers - **CoinGecko** — Crypto prices, market caps, and volumes ## FAQ ### What authentication does the Moon Catcher Wire REST API use? Per its OpenAPI spec, GET /stories uses HTTP bearer authentication with a portal API key in the form mcw_..., which the account holder creates in the Moon Catcher Wire portal. GET /topics is open and needs no key. Through Jentic the key is stored by your own Jentic One instance and attached at call time. ### Can I filter crypto news by ticker with the Moon Catcher Wire REST API? Yes. GET /stories accepts a ticker query parameter such as BTC, plus topic, since_hours, breaking_only, and a limit from 1 to 60 with a default of 20. An unknown topic returns a 400 error, so read the slugs from GET /topics first. ### What are the rate limits for the Moon Catcher Wire REST API? The OpenAPI spec does not specify rate limits. Check the Moon Catcher Wire authentication notes at https://mooncatcherwire.com/auth.md for current limits on portal keys. ### Is there a Moon Catcher Wire MCP server? Yes - Moon Catcher Wire describes its own MCP server, which uses OAuth tokens with the news:read scope. You can also connect the REST API directly through Jentic: your agent gets both endpoints from the spec without loading another server's tool definitions into its context, your portal key is injected at call time by your self-hosted instance instead of living in an MCP config, and your rules decide which operations the agent may call. ### Can I limit what my agent is allowed to do with the Moon Catcher Wire REST API? Yes. The API is read-only, so the question is which reads the agent makes. Write a rule that allows GET /stories and GET /topics, and every call the agent makes is logged so you can see which tickers and topics it pulled. ### How do I get breaking crypto news through Jentic? Search Jentic for 'get breaking crypto news', load the GET /stories operation, and execute it with breaking_only set to true and an optional ticker or since_hours. The response returns matched stories with headline, impact, and sentiment. To run it on your own infrastructure, install Jentic One from its GitHub repo.