# ScholarPulse

Global scholarship and student finance intelligence API. Pay-per-query via x402 micropayments (USDC on Base).

## What ScholarPulse does

ScholarPulse gives students, families, and AI agents real-time intelligence on scholarships, financial aid, and student loan strategy — across 190+ countries.

## Endpoints

**GET /api/search** ($0.15) — Scholarship search by profile
Find matched scholarships from real-time sources. Required: ?major=. Optional: country, level, gpa, income, demographic, lang.
Example: /api/search?major=nursing&country=US&level=undergraduate&gpa=3.5&income=50000

**GET /api/global** ($0.15) — International scholarship matching
Cross-border funding: Chevening, DAAD, Fulbright, Commonwealth, Erasmus Mundus, CSC, MEXT, GKS, Türkiye Bursları, 50+ programs.
Required: ?nationality=&destination=. Example: /api/global?nationality=Indian&destination=UK&level=masters&field=engineering

**GET /api/government** ($0.10) — Country government programs
Official programs: India NSP, US Pell/TEACH, UK Student Finance, Germany BAföG, Japan MEXT, South Africa NSFAS, Brazil ProUni.
Required: ?country=. Example: /api/government?country=India&level=undergraduate

**GET /api/erasmus** ($0.08) — Erasmus+ program guide
EU student mobility grants, country group amounts, KA131/Erasmus Mundus eligibility. 33 countries, 800+ universities.
Required: ?from=&to=. Example: /api/erasmus?from=Spain&to=Germany&field=engineering&level=undergraduate

**GET /api/aid** ($0.12) — US financial aid estimate
College Scorecard data: net price by income bracket, Pell eligibility, institutional generosity, 4-year cost estimate.
Required: ?college=&income=. Example: /api/aid?college=University+of+Michigan&income=75000&family_size=4

**GET /api/fafsa** ($0.10) — FAFSA strategy
Student Aid Index estimate, Pell eligibility, maximize-aid actions, asset strategy, filing deadlines.
Required: ?income=. Example: /api/fafsa?income=75000&family_size=4&assets=50000&year=freshman

**GET /api/loans** ($0.12) — Student loan repayment strategy
All plans: US (SAVE/IBR/PAYE/ICR/Standard), UK (Plan 2/5), Australia (HELP), Canada (RAP). Monthly payment, total cost, refi analysis.
Required: ?balance=&income=. Example: /api/loans?country=US&balance=45000&income=55000&loan_type=federal

**GET /api/forgiveness** ($0.10) — Loan forgiveness eligibility
PSLF, TEACH, Nurse Corps, NHSC, military, state programs, profession-specific forgiveness with action plan.
Required: ?profession=. Example: /api/forgiveness?profession=teacher&employer_type=public-school&state=TX&years_in_service=3

**GET /api/roi** ($0.10) — Degree ROI analysis
Earnings vs. debt by major/level, debt-to-income ratio, payoff timeline, alternatives comparison.
Required: ?major=&debt=. Example: /api/roi?major=nursing&degree_level=bachelor&debt=45000&college=UT+Austin

**GET /api/merit** ($0.12) — Merit aid strategy
Automatic merit scholarships for this GPA/test profile, state programs (FL Bright Futures, GA HOPE, LA TOPS), net cost estimates.
Required: ?gpa=. Example: /api/merit?gpa=3.8&test_score=SAT+1400&major=engineering&state=TX

**GET /api/deadline** ($0.08) — Scholarship deadline tracker
Real-time deadlines sorted by urgency, amounts, difficulty, quick-win opportunities. Poll weekly.
Example: /api/deadline?country=US&major=nursing&level=undergraduate&month=next

**GET /api/essay** ($0.10) — Essay strategy coaching
Committee values, winning angle, structure, insider tips per scholarship. Strategy only.
Required: ?scholarship=&prompt=. Example: /api/essay?scholarship=Gates+Scholarship&prompt=Describe+your+community+impact

## Payment

All endpoints require x402 payment (USDC on Base mainnet). Send GET without PAYMENT-SIGNATURE → receive 402 → sign → retry.

- Network: eip155:8453 (Base)
- Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 (USDC)
- Recipient: 0x50ab2018c06c6E4eAA9BA52057Eb55eD284912fc

## Global coverage

?lang= parameter on all endpoints — Claude responds in any language.
Coverage: North America, Europe (Erasmus+, DAAD), Asia-Pacific (MEXT, JASSO, GKS, CSC), South Asia (India NSP, 100M+ eligible), MENA (Türkiye Bursları, Gulf scholarships), Africa (Mastercard Foundation, NSFAS, AfDB), Latin America (CAPES, CONAHCYT, Colfuturo).