# QuickPoll
> Access curated survey data from global opinion polls (Eurobarometer, Gallup, World Bank) with AI analysis, and launch your own custom micro-polls on ad networks to gather real-time public opinion.

QuickPoll = AI survey research + ad-driven micro-polling behind x402 micropayments. Two paid endpoints: POST /poll/research queries curated global survey datasets (Eurobarometer, Gallup, World Bank) with LLM analysis and returns cited data points; POST /poll/request launches a live micro-poll on an ad network (Adexium) that reaches real people. Live poll pages and results are served free ({poll_id}, /poll/results/{poll_id}, /poll/vote/{poll_id}).

## Pricing
- `exclusive` tier — **$0.256125** on Base: `/poll/research`, `/poll/request`
- Chains: Base, Arbitrum, Polygon, Avalanche. Per-chain prices in `/.well-known/x402.json`.

## Operations
### inference
- **POST /poll/research** — Query curated survey data (Eurobarometer, Gallup, World Bank) with LLM analysis — cited data points on consumer sentiment, public opinion, and economic indicators across countries. — params: `query` (string)*, `country` (string) (tier: `exclusive`)

### generate
- **POST /poll/request** — Launch a micro-poll on the web via push notifications or popunders (Adexium) — get responses from real people. Requires question, options, and an ad budget. — params: `question` (string)*, `options` (array)*, `budget_usdc` (number), `network` (string) (tier: `exclusive`)

## Workflows
- **quickpoll_research** (Cited cross-country opinion/survey data): `poll_research`
- **quickpoll_launch** (Launch a live micro-poll to real people): `poll_request`

## Data sources
- Eurobarometer (survey) — EU public opinion.
- Gallup (survey) — Global sentiment data.
- World Bank (economic-indicators)
- Adexium (ad-network) — Micro-poll delivery.

## Free endpoints
- GET `/`, `/health`, `/about`, `/.well-known/x402.json`, `/llms.txt`, `/openapi.json` (standard)
- POST `/poll/vote/{poll_id}` — Cast a vote on a live poll
- GET `/poll/{poll_id}` — View a live poll page
- GET `/poll/results/{poll_id}` — Get poll results with statistical analysis
- GET `/quickpoll/feedback` — Return the 50 most recent feedback entries
- POST `/quickpoll/feedback` — Submit feedback

## Examples
- `poll_research` — Research sentiment: `{"query": "remote work adoption in Germany", "country": "DE"}`
- `poll_request` — Launch a poll: `{"question": "iOS vs Android?", "options": ["iOS", "Android"], "budget_usdc": 2.0}`