Create Gig
Creates a new gig with specified parameters. The gig will be created in a non-production state and will need to be funded before it can be started.
Authentication
You MUST include an API key in the request headers:
x-api-key: your_api_key_here
Contact the Gigbot team to get your API key
Requests without a valid API key will be rejected with a 401 status code
Keep your API key secure and do not share it with others
Endpoint
POST https://gigbot.xyz/api/gigs/create
Input Parameters
{
chain: "base", // Currently only Base network supported
token_address: string, // ERC20 token contract address
amount: number, // Reward amount in tokens (e.g., 10)
start_time: string, // ISO datetime (e.g., "2025-03-01T15:00:00Z")
duration: "1day" | "3days" | "1week" | "2weeks" | "3months" | "6months",
gig_type: "mention" | "like" | "recast" | "boost" | "custom_bounty",
how_to_earn?: string, // Required for `custom_bounty` else is Optional
earning_criteria?: string, // Optional - will use default if not provided
url?: string, // Required for like, recast, and boost tasks
platform?: "farcaster" | "x" // Optional - defaults to "farcaster"
}
Examples
Mention Gig
{
"chain": "base",
"token_address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
"amount": 10,
"start_time": "2025-03-01T15:00:00Z",
"duration": "1week",
"gig_type": "mention",
"platform": "farcaster"
}
Like Gig
{
"chain": "base",
"token_address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
"amount": 10,
"start_time": "2025-03-01T15:00:00Z",
"duration": "1week",
"gig_type": "like",
"url": "https://farcaster.xyz/gigbot.eth/0xf50c91de",
"platform": "farcaster"
}
Success Response (201)
{
gig_id: number, // Unique identifier for the created gig
gig_wallet_address: string, // Wallet address for reward distribution
gig_token_address: string, // Token contract address
gig_chain_id: number, // Chain ID (e.g., 8453 for Base)
gig_balance: string, // Reward amount in tokens
platform_fee: string, // Platform fee amount
total_amount: string, // Total including platform fee
tx_data: string // Encoded transaction data
}
Errors
401: Unauthorized
{
"error": "Invalid API key"
}
400: Validation Errors
{
"error": "Validation failed",
"details": ["Invalid chain", "URL required for like tasks"]
}
404: Resource Not Found
{
"error": "Chain not found"
}
500: Server Error
{
"error": "Failed to create gig"
}
Important Notes
Duration Options
1day: 24 hours (quick promotions)
3days: 72 hours (weekend events)
1week: 7 days (standard campaigns)
2weeks: 14 days (longer campaigns)
3months: 90 days (seasonal campaigns)
6months: 180 days (long-term campaigns)
URL Format Requirements
Farcaster:
https://farcaster.xyz/{username}/0x{hash}
X/Twitter:
https://twitter.com/{username}/status/{tweet_id}
Platform Support
farcaster
x
Last updated