Claude Code Skill — /bf-create-market

The bf-create-market Claude Code skill is the simplest way to launch BlockForecast markets from an AI agent. Install once, run a slash command, the skill handles the rest: derives your wallet from a private key, checks creator approval, signs the $1 USDC payment via x402 on Base, posts the market, and returns the URL. Creator-fee earnings (0.5% of every trade) flow back to your wallet automatically. If you’re not using Claude Code, see the manual x402 Quickstart — same endpoint, you write the glue code.

Install

In a Claude Code session:

/plugin marketplace add gr8estman/blockforecast-skills
/plugin install bf-create-market@gr8estman

The skill is open source — source on GitHub: gr8estman/blockforecast-skills.

One-time setup

Get an EVM wallet

Any tooling — viem, MetaMask, Coinbase, hardware wallet. The skill needs the private key of the wallet your agent will create markets from.

import { generatePrivateKey, privateKeyToAccount } from 'viem/accounts';
const key = generatePrivateKey();
console.log('address:', privateKeyToAccount(key).address);
console.log('key:    ', key);

Save the key in your secrets manager (1Password, Doppler, AWS Secrets Manager, env file in your secrets store) — this is plain-text private-key custody, treat it accordingly.

Fund with USDC on Base

Send ~$5 USDC (Base mainnet) to the agent address. Bridge from Ethereum mainnet via the official Base bridge, or off-ramp directly from Coinbase to Base. Each market creation costs $1 USDC plus a few cents of gas.

Apply for creator access

Visit blockforecast.io/apply and sign in with the same wallet (use “Connect wallet” → External wallet). Submit the application. Approval typically lands in under 24 hours — there’s no outbound notification, so check /create to see your status.

The skill will not call the paid endpoint until your wallet shows status: approved. The $1 x402 fee is non-refundable on unapproved wallets, so apply first.

Set the env var

export BF_AGENT_KEY="0x<your-64-char-hex-key>"

Add it to your shell rc, your secrets store, or whatever launches your Claude Code session.

Usage

/bf-create-market "Will the Fed cut rates in May 2026?" 2026-05-31

The skill will:

Check BF_AGENT_KEY is set
Verify the wallet is approved
Show you a confirmation summary
Wait for your “yes” before spending USDC
POST to BlockForecast with x402 payment
Return the live market URL

Dry run

To verify your setup without spending USDC:

DRY_RUN=1 /bf-create-market "Will X happen by Y?" 2026-12-31

The skill runs all preflight checks and prints what it would send, then exits.

Inputs

Argument	Required	Format	Notes
`question`	yes	string ≥10 chars	Binary, ends with `?`
`resolveDate`	yes	`YYYY-MM-DD`	Must be in the future
`category`	no	one of `crypto`, `politics`, `sports`, `culture`, `science`, `world`, `ai`, `esports`	Default: `crypto`

Behind the scenes the skill POSTs to /api/v2/x402/markets — the Create Market via x402 page documents the underlying payload and response.

Costs

Action	Cost
Apply for creator access	Free
Create one market via the skill	$1 USDC + ~$0.001 gas
Earn from trades on your market	0.5% of every trade — paid to your wallet in real time
Withdraw earnings	Gas only

A market doing $50k of lifetime volume nets the creator $250. Most active creators run a portfolio of 30+ markets.

Errors and what to do

Skill error	Meaning
`missing_key`	Run `export BF_AGENT_KEY="0x..."`
`bad_key`	Key must be 32 bytes hex with optional `0x` prefix
`creator_not_approved`	One-time apply at /apply
`creator_pending`	Wait for approval (~24h) — re-check at /create
`creator_rejected`	See rejection reason; address it; reapply at /apply
`creator_suspended`	Contact support@blockforecast.io
`insufficient_usdc`	Add USDC on Base to the agent wallet
`payment_failed`	Coinbase CDP facilitator hiccup — retry in a minute

Security notes

The skill only signs the exact x402 payment payload for POST /api/v2/x402/markets. It does not trade, withdraw, or move funds.
Creator-fee earnings flow to the wallet derived from BF_AGENT_KEY. Keep that key tightly scoped — anyone with it can also withdraw your earnings.
The skill prompts for explicit confirmation before every paid call. There is no auto-execute mode.
Treat BF_AGENT_KEY like a production secret: rotate periodically, never commit, never paste in chat.

Roadmap

These skills are planned next — they share the same wallet + creator setup:

bf-resolve-oracle — query oracle consensus on any yes/no question ($0.05 USDC per call)
bf-check-balance — read agent wallet’s USDC balance + open positions
bf-list-markets — search BlockForecast markets by category
bf-trade — place a trade on an existing market

Source + support

Skill source: github.com/gr8estman/blockforecast-skills
Issues / feature requests: open one on GitHub
Email: support@blockforecast.io

API

x402 Agent API

Skills & SDKs

Claude Code Skill — /bf-create-market

Install

One-time setup

Usage

Dry run

Inputs

Costs

Errors and what to do

Security notes

Roadmap

Source + support

​Install

​One-time setup

​Usage

​Dry run

​Inputs

​Costs

​Errors and what to do

​Security notes

​Roadmap

​Source + support

Install

One-time setup

Usage

Dry run

Inputs

Costs

Errors and what to do

Security notes

Roadmap

Source + support