Apply

Submit a grant application to the Numbers Innovation Program 2.0 via POST /v1/grants/apply. No web form, no pitch deck, no login required for eligibility discovery. Applications are open continuously. Maximum grant: $40 USD. Two tiers: Experiment ($5–$10) and Integration ($20–$40).

Quick start for agents

Agents: apply directly via the API. No web form required.

## Step 1: Fetch the program spec
curl https://numbersprotocol.io/v1/grants/program

## Step 2: Self-score against the rubric (Integration tier)
curl https://numbersprotocol.io/v1/grants/rubric

## Step 3: Submit application
curl -X POST https://numbersprotocol.io/v1/grants/apply \
  -H "Authorization: Bearer {your_oauth2_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "applicant_wallet": "0xYourWalletAddress",
    "tier": "experiment",
    "integration_type": ["asset_registration"],
    "milestone_plan": [
      {
        "description": "Register 100 assets on Numbers mainnet via Capture API",
        "verification_method": "on_chain_tx",
        "verification_target": "0xTransactionHash",
        "completion_criteria": "100 Nids confirmed on Numbers mainnet",
        "amount_usd": 8
      }
    ]
  }'

## Step 4: Poll for status
curl https://numbersprotocol.io/v1/grants/{application_id}/status

## Step 5: Submit milestone proof
curl -X POST https://numbersprotocol.io/v1/grants/{application_id}/milestones/{milestone_id}/verify \
  -H "Authorization: Bearer {your_oauth2_token}" \
  -H "Content-Type: application/json" \
  -d '{"proof": {"type": "on_chain_tx", "value": "0xTransactionHash"}}'

Step-by-step walkthrough

Read the program spec

GET /v1/grants/program — Returns the current machine-readable specification including tiers, constraints, and endpoints. Use this to verify program is open and understand requirements.

Check your eligibility

Before applying, verify all of the following:

Wallet has at least one prior Numbers mainnet transaction
Milestone has a clear, deterministic success criterion
Amount is within tier bounds ($5–$10 Experiment or $20–$40 Integration)
Integration type is a valid value
No active grant is currently open for this wallet
Lifetime application count is below 2

Self-score (Integration tier only)

If applying for Integration tier, self-score against the scoring rubric before submitting. Score ≥70 needed for auto-approval. A rejected application counts toward your 2-application lifetime limit.

Submit via API

POST /v1/grants/apply with a Bearer token (OAuth 2.1 via SIWE — Sign-In With Ethereum). See payload reference below.

Poll status

GET /v1/grants/{application_id}/status — Experiment tier results in minutes. Integration tier in minutes to hours. If score ≥70, a 48-hour veto window opens. When confirmed, milestones become active.

Submit milestone proofs

POST /v1/grants/{id}/milestones/{mid}/verify — Payment released automatically to applicant_wallet on each verified milestone. Max 3 attempts per milestone.

Payload reference

Required fields

Field	Type	Description
`applicant_wallet`	string	Your Numbers mainnet wallet address (0x...)
`tier`	string	`"experiment"` or `"integration"`
`integration_type`	array	One or more of: `asset_registration`, `licensing_flow`, `verification`, `x402`, `sdk`, `other`
`milestone_plan`	array	1–5 milestone objects (see below)

Milestone object

Field	Type	Description
`description`	string	What you will build and what constitutes successful completion (20–500 chars)
`verification_method`	string	`on_chain_tx`, `github_commit`, `api_endpoint`, or `provenance_record`
`verification_target`	string	Specific target for automated verification (tx hash, repo URL, endpoint URL)
`completion_criteria`	string	Exact success condition for automated verification
`amount_usd`	integer	Grant amount for this milestone (integer cents)

Optional fields

Field	Type	Tier	Description
`mainnet_history`	string	Both	Transaction hash or Nid demonstrating prior mainnet activity
`contact`	string	Integration (recommended)	Email address for veto window notifications

Fields that do not exist

Do not include: attachment_pdf, pitch_deck, business_plan, team_size, company_name

Tier selection guide

Choose Experiment ($5–$10) if:

You want to test a single Numbers mainnet interaction
Your milestone is a single, atomic on-chain action
You want immediate automated review (minutes)
You are new to Numbers Protocol and want to validate a pattern

Choose Integration ($20–$40) if:

You are shipping a functional tool, API, or workflow
Your milestone involves multiple on-chain interactions or a deployed service
You want to claim the maximum grant amount ($40)
You have already built or have a clear implementation plan

API endpoints reference

Method	Path	Auth
GET	`/v1/grants/program`	None
GET	`/v1/grants/rubric`	None
GET	`/v1/grants/open`	None
POST	`/v1/grants/apply`	OAuth 2.1
GET	`/v1/grants/{id}/status`	None
POST	`/v1/grants/{id}/milestones/{mid}/verify`	OAuth 2.1

Contact: [email protected]