Creating Incentives

Use generate_incentive_query with the appropriate source:

Swap — track DEX trades:

source: "swap"
tokenMint: "your-token-mint"
direction: "buy"
measure: "volume"

Bonding Curve — track launchpad trades. Each token launched on a launchpad has a unique identifier that locates its bonding curve on-chain: a pool state address on Raydium LaunchLab, or a genesis account address on Metaplex Genesis. Ask the user for the relevant identifier (they can get it from the launchpad UI) — no separate token mint needed; the pool/genesis account already uniquely identifies that token's curve.

For Raydium LaunchLab, ask the user for the pool state address:

source: "bonding_curve"
launchpad: "raydium_launchlab"
poolState: "pool-state-address"
direction: "buy"
measure: "volume"

For Metaplex Genesis, ask the user for the genesis account address:

source: "bonding_curve"
launchpad: "metaplex_genesis"
genesisAccount: "genesis-account-address"
direction: "buy"
measure: "volume"

Hold — track token holders:

source: "hold"
tokenMint: "your-token-mint"
measure: "balance"
minBalance: 1000

Use preview_incentive_query to validate against real data:

sqlQuery: "<the generated SQL>"

Use create_recurring_incentive with the query and reward configuration:

name: "Weekly Swap Leaderboard"
type: "leaderboard"
emissionType: "TOKENS"
tokenAddress: "your-token-mint"
tokenDecimals: 9
totalFundAmount: 1000
interval: "WEEKLY"
startDate: "2026-01-01T00:00:00Z"
sqlQuery: "<the generated SQL>"
customFormula: "RANK == 1 ? 500 : RANK <= 3 ? 200 : RANK <= 10 ? 50 : 0"

Always call with confirmed: false first to preview the 5% protocol fee (added on top of totalFundAmount — the creator pays totalFundAmount × 1.05) and the 7-day claim window.

Use create_custom_event:

eventName: "content_share"
name: "Content Share"
fields: [
  { fieldName: "platform", type: "string" },
  { fieldName: "reach", type: "number" },
  { fieldName: "verified", type: "boolean" }
]

Schemas are project-independent. Use attach_custom_event to make the schema available on the active project:

customEventId: "<the event ID from step 1>"

Use the ingestion API with your API key (see API Keys):

curl -X POST https://ingest.torque.so/events \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "userPubkey": "wallet-address",
    "timestamp": 1234567890000,
    "eventName": "content_share",
    "data": {
      "platform": "twitter",
      "reach": 1500,
      "verified": true
    }
  }'

Generate the query:

source: "custom_event"
customEventId: "<the event ID>"
valueExpression: "SUM(reach)"
filters: ["verified = true"]

Preview with preview_incentive_query, then create with create_recurring_incentive (include customEventId in the creation call).

Call create_idl with confirmed: false on the IDL file — this parses locally and lists available instructions, fields, and accounts. No auth or active project required in this phase.

filePath: "/path/to/your/idl.json"
confirmed: false

Call create_idl again with confirmed: true and the instructions you want to track:

filePath: "/path/to/your/idl.json"
confirmed: true
displayName: "My Program"
selectedInstructions: [
  {
    instructionName: "buy_exact_in",
    fields: [
      { fieldName: "amount_in", type: "number" },
      { fieldName: "min_amount_out", type: "number" }
    ],
    accounts: ["payer", "pool"]
  }
]

Generate the query:

source: "idl_instruction"
instructionId: "<the instruction ID from step 2>"
valueExpression: "SUM(amount_in)"

Preview with preview_incentive_query, then create with create_recurring_incentive (include instructionId in the creation call).

Use register_dune_event_source with the column mapping:

duneQueryId: 1234567
queryName: "Daily Active Traders"
fields: [
  { duneColumn: "volume_usd", fieldName: "volume_usd", type: "number" },
  { duneColumn: "trade_count", fieldName: "trade_count", type: "number" }
]
userPubkeyField: "wallet_address"
eventTypeField: "trade_type"
timestampField: "trade_time"
dateParamName: "date"
txHashField: "tx_hash"
usdValueField: "volume_usd"

Call once with confirmed: false to preview, then again with confirmed: true. The tool returns a duneEventQueryId — save it for the generate-preview-create step below.

Through the Dune MCP: executeQueryById with a recent date for dateParamName, then getExecutionResults. Confirm the execution succeeds and returns rows with the expected columns. If it errors or returns no rows, fix the Dune query (via the Dune MCP) before proceeding.

Torque ingests Dune query results on a daily schedule. generate_incentive_query rejects Dune sources until their column mapping is populated by the first ingestion run — expect up to 24 hours.

Generate the query:

source: "dune_query"
duneEventQueryId: "<the UUID from step 1>"
valueExpression: "SUM(volume_usd)"

Note: pass the Torque-side duneEventQueryId UUID — NOT the numeric Dune duneQueryId.

Preview with preview_incentive_query, then create with create_recurring_incentive.