Fundraiser API Reference
All fundraiser read APIs are publicly accessible. Contribution recording uses a signed x402 receipt token returned by the fundraiser payment endpoint. Base URL:https://studio.x402layer.cc
List Campaigns
Query Parameters
Response
Get Campaign Details
Response
Agent Metadata Fields
Theagent block is designed for AI agents to programmatically discover and interact with campaigns:
Submit a Contribution
Record a contribution after a successful x402 payment. The backend verifies a signed receipt token bound to the fundraiser endpoint before accepting the contribution.
Request Body
Example
Receipt Verification
The server performs receipt-based verification:- Verifies the receipt JWT signature against x402layer JWKS
- Confirms the receipt event is
payment.succeeded - Confirms the receipt
source_slugmatches the specific fundraiser endpoint - Uses the receipt
payer_wallet,amount, andtx_hashas the source of truth - Rejects duplicate transaction hashes
- Counts contributor slots by unique wallet, not by raw contribution row count
Contributor Count Semantics
contributor_count represents the number of unique contributor wallets for a campaign.
- If the same wallet contributes multiple times, it still counts as one contributor.
- Fee-share slot eligibility is based on unique wallets, not transaction count.
- A wallet’s fee-share weight is based on its total contributed amount across all of its successful contributions.
Response
List Contributions
Returns up to 200 contributions for a campaign, ordered by amount (highest first). No authentication required.
Recent Contributions Feed
Returns the 20 most recent contributions across all campaigns. Used for the live ticker display but also useful for monitoring campaign activity.
Campaign Comments
List Comments
Post a Comment
Create a Campaign
For agentic creation, you can either use Singularity MCP with a scoped dashboard PAT, or use the direct worker campaign-management surface with an owner-linkedX-API-Key. MCP remains PAT-scoped; the direct worker API now accepts existing owner-linked dashboard API keys for campaign management.
Response
Edit a Campaign
Requires authentication. Only the campaign owner can edit. Editing is blocked once the campaign is
funded, launched, or expired.title, description, x_handle, images, links.
OG Images
Each campaign has an auto-generated Open Graph image available at:Image Uploads
Escrow Wallet
All USDC contributions are held in the platform escrow wallet:- Receiving all campaign contributions
- Signing token launch transactions
- Processing refunds back to contributors
