# EduPulse

> The universal AI tutor and exam prep API. Every subject. Every exam. Every certification. Every language. Powered by Claude, gated by x402 micropayments on Base.

## What This Is

EduPulse is a pay-per-query API that generates high-quality educational content on demand — study guides, practice quizzes, exam-style questions, flashcard sets, mock exams, and backwards-planned study schedules.

There are no subject or exam restrictions. EduPulse covers:
- Every K-12 subject (all grades, all Common Core subjects)
- Every undergraduate and graduate college course
- Every professional licensing exam (NCLEX, Bar, CPA, LSAT, MCAT, Series 3/7, USMLE, PMP, CFA, CFP, real estate, electrician, HVAC, CDL, FAA, air traffic control, and any other credential)
- Every continuing education requirement in any profession
- Every language (Claude responds natively in any language via ?lang= parameter)

## Payment

All endpoints require x402 micropayment (USDC on Base mainnet).
Protocol: x402 | Network: eip155:8453 | Asset: USDC
Payment address: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

To use: send a GET request without a PAYMENT-SIGNATURE header to receive a 402 response with payment requirements. Sign the payment and retry with the PAYMENT-SIGNATURE header.

## Endpoints

### Study (K-12 and General)

GET /api/study/guide?grade={grade}&subject={subject}&topic={topic}
- Returns: comprehensive study guide with key concepts, step-by-step explanation, practice problems, memory tips, and book recommendations
- Price: $0.10
- Example: /api/study/guide?grade=9&subject=algebra&topic=quadratic+equations

GET /api/study/quiz?grade={grade}&subject={subject}&topic={topic}&questions={n}&difficulty={level}
- Returns: practice quiz with 4-option questions and full answer explanations
- Price: $0.10
- Example: /api/study/quiz?grade=10&subject=biology&topic=mitosis&questions=5

GET /api/study/explain?concept={concept}&grade={grade}&audience={audience}
- Returns: plain-English concept explanation with analogy, memory trick, and common misconceptions
- Price: $0.05
- Example: /api/study/explain?concept=present+value&audience=Series+7+candidate

GET /api/study/schedule?exam={exam}&date={YYYY-MM-DD}&hours_per_week={n}
- Returns: week-by-week backwards-planned study calendar from today to exam date
- Price: $0.10
- Example: /api/study/schedule?exam=NCLEX&date=2026-09-01

### Exam Prep (Any Certification Worldwide)

GET /api/exam/prep?exam={exam}&topic={topic}&questions={n}&difficulty={level}
- Returns: authentic exam-style questions with detailed rationales matching real exam format
- Price: $0.15
- Example: /api/exam/prep?exam=Journeyman-Electrician&topic=NEC+load+calculations&questions=5

GET /api/exam/flashcards?exam={exam}&topic={topic}&section={section}&count={n}
- Returns: high-yield spaced-repetition flashcard set with memory tips
- Price: $0.08
- Example: /api/exam/flashcards?exam=CPA&section=FAR&topic=lease+accounting&count=15

GET /api/exam/explain?exam={exam}&question_type={type}
- Returns: format explainer with strategy guide and fully worked example
- Price: $0.08
- Example: /api/exam/explain?exam=NCLEX&question_type=NGN

GET /api/exam/mock?exam={exam}&duration={minutes}
- Returns: full 20-question timed mock exam with questions section (for self-testing) followed by complete answer key and rationales
- Price: $0.25
- Example: /api/exam/mock?exam=Series-3&duration=60

## Discovery

- OpenAPI spec: https://edupulse-xi-blond.vercel.app/openapi.json
- Agent discovery: https://edupulse-xi-blond.vercel.app/.well-known/agent.json

## Notes for AI Agents

- All endpoints return structured JSON
- All endpoints support ?lang= parameter — Claude responds natively in any human language
- No exam or subject is out of scope — if you need prep content for any credential not listed above, pass it as the exam parameter and Claude will generate appropriate content
- The ?exam= parameter accepts free-form text — e.g. "California-Real-Estate-License", "Master-Electrician-Texas", "Organic-Chemistry-201", "Air-Traffic-Controller-Recurrency"
- Responses include Amazon affiliate book recommendations where applicable