# GrantPulse

> Grant discovery and application intelligence API. 8 endpoints: personalized grant matching across federal, state, and foundation sources; live Grants.gov search with CFDA data; state grant programs; private foundation intelligence; criterion-by-criterion eligibility analysis; application strategy to win specific grants; deadline tracking; and grant narrative section drafting. Powered by Grants.gov public API, USASpending.gov, and Claude. Pay-per-query via x402 on Base.

$200B+ in grants given away annually — most unclaimed because discovery is opaque. GrantPulse changes that.

## Payment

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

## Endpoints

GET /api/grant/match?org_type={type}&mission={mission}
- Flagship personalized grant matching — federal (Grants.gov), state programs, and private foundations curated for this org's type and mission
- Returns: federal_grants, state_grants, foundation_grants (each with title, agency, award range, deadline, why_you_qualify, fit_score, link), sbir_sttr_flag, quick_wins, funding_strategy
- Required: org_type, mission. Optional: location, sector, size, lang
- org_type values: nonprofit | small_business | individual | public_university | private_university | state_government | local_government | tribal | for_profit | other
- Price: $0.15

GET /api/grant/federal?keyword={keyword}
- Live federal grant search via Grants.gov — open opportunities with CFDA numbers, award ranges, deadlines, eligibility, and past award context from USASpending.gov
- Returns: opportunities, landscape_context, agency_insights, sbir_sttr_note
- Required: keyword. Optional: eligibility, category, lang
- Price: $0.10

GET /api/grant/state?state={state}
- State grant programs for any US state — small business development, arts councils, community development, workforce, agriculture
- Returns: grant_programs, sbdc_note, community_foundations, application_calendar, insider_tips
- Required: state. Optional: sector, org_type, lang
- Price: $0.10

GET /api/grant/foundation?mission={mission}
- Private foundation, family foundation, community foundation, and corporate giving programs
- Returns: foundation_matches (with fit_score, cultivation_tip, approach), corporate_giving, loi_strategy, relationship_building, realistic_timeline
- Required: mission. Optional: location, size, org_type, lang
- Price: $0.12

GET /api/grant/eligibility?grant_name={name}&org_type={type}
- Criterion-by-criterion eligibility analysis for a specific grant
- Returns: eligibility_verdict, confidence, eligibility_analysis, hard_disqualifiers, gray_areas, worth_applying, questions_to_ask_program_officer
- Required: grant_name, org_type. Optional: org_profile, agency, lang
- Price: $0.10

GET /api/grant/apply?grant_name={name}
- Application strategy to WIN a specific grant
- Returns: funder_priorities, review_criteria (with weights), winning_narrative_elements, positioning_advice, budget_strategy, application_timeline, red_flags_to_avoid
- Required: grant_name. Optional: agency, org_type, mission, lang
- Price: $0.15

GET /api/grant/deadline?category={category}
- Grant deadline calendar — urgent (closing within 30 days), closing soon, upcoming, rolling
- Returns: urgent (with days_remaining), closing_soon, upcoming, rolling_opportunities, annual_calendar, this_week_action
- Required: at least one of category or org_type. Optional: days (default 90), lang
- Price: $0.08

GET /api/grant/writer?section={section}&org_type={type}&mission={mission}
- Professional grant narrative section drafts ready to customize
- Returns: drafted_text (300-600 words), data_to_insert, what_to_strengthen, formatting_tips
- Required: section, org_type, mission
- section values: problem_statement | project_description | evaluation_plan | budget_narrative | org_background | executive_summary | goals_objectives
- Optional: grant_name, org_description, project_description, lang
- Price: $0.20

GET /api/grant/eu?org_type={type}&sector={sector}&country={country}
- EU funding intelligence — Horizon Europe, ERC, structural funds, and all EC grant programmes
- Returns: funding_landscape, horizon_europe_opportunities (programme/amount/deadline/fit_score), structural_funds (ERDF/ESF+/CF), other_eu_programmes (LIFE/Creative Europe/Erasmus+), quick_wins, consortium_note, national_contact_point guidance, verification_links
- At least one of org_type, sector, or mission required; country optional (EU member state)
- Consortium note: many Horizon calls require partners from 3+ member states — flagged
- Price: $0.12

GET /api/grant/global?sector={sector}&country={country}&mission={mission}
- Global development funding — World Bank, UN agencies, bilateral donors, major foundations
- Returns: funding_landscape, world_bank_opportunities, un_agency_grants, bilateral_donors (USAID/GIZ/FCDO/JICA), major_foundations, quick_wins, iati_note, capacity_building_note, verification_links
- Powered by World Bank Projects API (free, live data) + IATI transparency context
- At least one of sector, country, or mission required
- Price: $0.15

## Data Sources

- Grants.gov REST API — 50,000+ active federal grant opportunities, free, no key required
- USASpending.gov API — past federal award history by keyword, free, no key required
- World Bank Projects API — active development grants globally, free, no key required
- Tavily — state programs, foundation grants, EU calls, international development context
- Claude Sonnet — synthesis, eligibility analysis, strategy, and narrative drafting

## Agent Workflow Examples

- US grant strategy: /match → /eligibility (top matches) → /apply (best fit) → /writer (key sections)
- EU researcher: /eu → /eligibility (top Horizon call) → /apply → /writer
- Global NGO: /global → /eligibility → /apply → /writer
- Deadline-driven: /deadline → /eligibility (urgent ones) → /apply
- Foundation campaign: /foundation → /apply (top foundation) → /writer (LOI draft)

## Notes for AI Agents

- /match is the best starting point — spans all three funding sources in one call
- /writer produces draft text ready to submit — user fills in [BRACKETS] with specifics
- SBIR/STTR flagged in /match and /federal for small businesses — $150k–$2M+ per award
- Always recommend calling the program officer before applying — flagged in /eligibility and /apply
- All endpoints support ?lang= for native-language responses

## Disclaimer

For informational purposes only. Verify all grant details, deadlines, and eligibility directly with funding sources before applying.