FAQ
General
Section titled “General”What data does Opelyx provide?
Section titled “What data does Opelyx provide?”Opelyx provides two main data products:
- Health Plans API — ACA marketplace health insurance plans across all 50 states + DC, with plan search, comparison, cost estimation, and subsidy calculation
- MCP Financial Data Server — 14 tools for SEC EDGAR filings, prediction markets (Polymarket, Kalshi, Manifold), and DOGE government spending data
Is the data real-time?
Section titled “Is the data real-time?”Health plan data is updated annually at the start of each plan year (sourced from CMS PUFs and state exchanges). MCP financial data tools fetch live data from their respective sources with caching (60 seconds for prediction markets, 5-10 minutes for SEC/DOGE data).
What states does the Health Plans API cover?
Section titled “What states does the Health Plans API cover?”All 50 states plus Washington, DC. Coverage includes 30 states on the Federal marketplace (HealthCare.gov) and 21 states with their own State-Based Marketplaces.
Authentication
Section titled “Authentication”How do I get an API key?
Section titled “How do I get an API key?”Sign up at dashboard.opelyx.com. You’ll receive a free API key immediately — no credit card required.
Can I have multiple API keys?
Section titled “Can I have multiple API keys?”Yes. Create multiple keys in the dashboard to separate development, staging, and production traffic.
What happens if my API key is compromised?
Section titled “What happens if my API key is compromised?”Revoke it immediately from the dashboard and create a new one. Revocation takes effect within seconds.
Rate Limits
Section titled “Rate Limits”How do rate limits work?
Section titled “How do rate limits work?”Each API key has a daily request allowance based on your tier: Free (100/day), Pro (10,000/day), Enterprise (100,000/day). Limits reset at midnight UTC.
What happens when I exceed the limit?
Section titled “What happens when I exceed the limit?”You receive a 429 Too Many Requests response with a Retry-After header indicating how many seconds to wait. The response also includes an upgrade URL.
Do MCP tool calls count against my limit?
Section titled “Do MCP tool calls count against my limit?”Yes, each MCP tool invocation counts as one request against the same daily limit.
Billing
Section titled “Billing”Can I try Pro features for free?
Section titled “Can I try Pro features for free?”Not currently. The Free tier provides access to most API features. Pro adds advanced filters, plan comparison, and APTC calculation.
How do I cancel my subscription?
Section titled “How do I cancel my subscription?”Cancel anytime from the Billing page in the dashboard. Your Pro access continues until the end of the current billing period.
Do you offer refunds?
Section titled “Do you offer refunds?”Contact support@opelyx.com within 7 days of purchase for a full refund.
Technical
Section titled “Technical”What response format does the API use?
Section titled “What response format does the API use?”JSON with HAL (Hypertext Application Language) format — _links for navigation and _embedded for nested resources. Errors use RFC 9457 Problem Details format.
Do you support CORS?
Section titled “Do you support CORS?”Yes, with explicit origin allowlists. Requests from *.opelyx.com domains are allowed. Contact support for custom origin allowlisting.
Is there a sandbox/test environment?
Section titled “Is there a sandbox/test environment?”Not currently. Use the Free tier for development and testing. Example plan IDs and ZIP codes work in production with real data.