---
name: good-grants-api
description: Search current U.S. federal grant notices, retrieve official details, score mission fit, generate sourced briefs, and preflight a shortlist using Grants.gov public records.
homepage: https://genuinegood.online/grants
baseUrl: https://genuinegood.online
manifest: https://genuinegood.online/.well-known/x402
openapi: https://genuinegood.online/openapi.json
contact: https://genuinegood.online/grants
---

# Genuine Good Grants API

Use this skill when an organization needs current U.S. federal grant discovery or a sourced first-pass review of a known opportunity. The service is independent and is not affiliated with Grants.gov or any U.S. agency. Results are research aids, not eligibility decisions, award promises, legal advice, or government endorsements.

## Resources

- `POST /v1/grants/search` — $5.00 USDC — Search current Grants.gov opportunities with normalized deadlines, days remaining, agency, status, assistance listing numbers, and official source links.
- `POST /v1/grants/detail` — $5.00 USDC — Retrieve an official Grants.gov opportunity with normalized applicant types, eligibility text, award range, deadline, categories, and provenance.
- `POST /v1/grants/fit` — $5.00 USDC — Rank current U.S. federal opportunities against a mission profile using transparent keyword, deadline, and applicant-type signals; returns reasons and official records.
- `POST /v1/grants/brief` — $5.00 USDC — Produce a sourced agent-ready brief of up to ten current U.S. federal grant matches, eligibility signals, deadline urgency, award ranges, and next actions.
- `POST /v1/grants/preflight` — $5.00 USDC — Run deterministic rule-based checks over up to five retrieved Grants.gov notices: deadline horizon, listed applicant-type code intersection, source-field completeness, and official-notice verification flags.
- `POST /v1/grants/pass` — $15.00 USDC — Activate 30 days of bearer-token access to every Genuine Good Grants API tool, subject to a 1,000-request fair-use limit. The client supplies its own random token; Genuine Good stores only its SHA-256 hash.

## Payment

- Protocol: x402 v2, exact scheme
- Network: eip155:8453
- Asset: USDC (ERC-20) on Base mainnet (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
- Recipient: 0x2f0050612d36537d4026b45Ba39B067a9c67b5c3
- Header on paid retry: `PAYMENT-SIGNATURE`
- Account or API key: not required

First call an endpoint without a payment header. Read its HTTP 402 `PAYMENT-REQUIRED` challenge, sign the quoted EIP-3009 authorization, then retry the same request with the encoded authorization in `PAYMENT-SIGNATURE`. A successful response includes `PAYMENT-RESPONSE`.

## Start safely

1. Read the machine contract at https://genuinegood.online/openapi.json.
2. Inspect the free sample at https://genuinegood.online/api/grants/preflight-sample.
3. Use https://genuinegood.online/v1/grants/search for broad discovery, then https://genuinegood.online/v1/grants/detail for the official notice record.
4. Treat `fit`, `brief`, and `preflight` as research support only; verify every decision against the linked official notice.

This product uses the Grants.gov API but is not endorsed or certified by the U.S. Department of Health and Human Services.