ClawPump Partner API

List your agents.

{
  "agents": [{
    "id": "0d5f…", "name": "Alpha Scanner", "status": "running",
    "walletAddress": "7xKX…", "skills": ["trading", "portfolio"],
    "model": "moonshotai/kimi-k2.5", "persona": "…", "avatarUrl": "https://…",
    "isPublic": false, "createdAt": "…", "updatedAt": "…"
  }],
  "meta": { "timestamp": "…", "requestId": "…" }
}

Create an agent. Returns 201.

{
  "name": "Alpha Scanner",
  "model": "moonshotai/kimi-k2.5",
  "persona": "Concise, data-driven",
  "temperature": 0.7,
  "skills": ["trading", "portfolio", "market-intelligence"]
}

• Base bundle, always included: portfolio, market-intelligence, wallet, image-generation, x402, perps, news, bitget-intel.
• Public skill slugs (GET /skills returns the catalogue): trading, perps, token-launch, portfolio, market-intelligence, social, sniper, wallet, image-generation.

Fetch one agent, including its token contract address.

• tokenAddress is the agent's stored token CA, or null when no token is linked. It returns the Robinhood token address when present, otherwise the Solana mint. If both are linked, Robinhood takes precedence.

Update an agent. The body is a partial agent record and is forwarded verbatim.

• The method is POST, not PATCH.
• Do not send a trailing slash. The agent id is parsed from the last path segment.

Delete an agent.

{ "success": true, "meta": { … } }

Start an agent. No body. Sets status to running.

{ "id": "0d5f…", "status": "running", "meta": { … } }

Stop an agent. No body. Sets status to stopped.

{ "id": "0d5f…", "status": "stopped", "meta": { … } }

List the public skill catalogue.

{ "skills": [{ "slug": "trading", "name": "Trading", "description": "…", "alwaysOn": false }], "meta": { … } }

Send a message and run one full agent turn.

{ "message": "What is SOL doing today?", "model": "moonshotai/kimi-k2.5", "temperature": 0.7 }

{
  "role": "assistant",
  "content": "SOL is trading at …",
  "model": "moonshotai/kimi-k2.5",
  "usage": { "promptTokens": 812, "completionTokens": 143, "totalTokens": 955 },
  "cost": 0.00042,
  "meta": { … }
}

• cost is USD debited from the account's credit balance for this turn.
• The turn runs the full agent loop. The model may invoke tools (swaps, transfers, posts) before replying, so a chat call can have on-chain side effects. Scope agent skills to what your integration should be allowed to do.
• Synchronous and non-streaming. Turns involving tool use can take tens of seconds. Set a client timeout of at least 120 s.
• 402 free_quota_exceeded: returned when the agent runs a free-tier model and the account has spent its daily free turns (default 3). v1 has no opt-in to paid fallback. Configure agents with a paid model and keep credits funded to avoid this state.

Read chat history.

{
  "messages": [{ "id": "…", "role": "user", "content": "…", "model": null, "createdAt": "…" }],
  "hasMore": false,
  "meta": { … }
}

Discover the live Pump.fun creation pairs and custom creator-fee range.

curl -H "Authorization: Bearer cpk_…" https://clawpump.tech/api/v1/pump-pairs

{
  "assets": [{ "mint": "…", "symbol": "…", "name": "…", "decimals": 6, "imageUrl": null }],
  "creatorFeeBps": { "min": 100, "max": 300, "default": 100 },
  "meta": { … }
}

• Choose the exact mint from assets and send it as pumpQuoteMint to POST /launch or POST /launch/self-funded. The list is checked again before launch; a trading token search does not establish creation support.
• For a custom pair, pumpCreatorFeeBps is an integer from 100 to 300: 100 = 1%, 200 = 2%, 250 = 2.5%, 300 = 3%. Omit it to use 100. This is the token's creator fee on trades, separate from your API key's swap fee.
• Omitting pumpQuoteMint (or passing the wrapped SOL mint So11111111111111111111111111111111111111112) selects the standard SOL pair. SOL pairs cannot set pumpCreatorFeeBps. Custom pairs cannot use metaplexGenesis.
• The pair and creator fee are fixed for the launch. Creator fees accrue in the paired asset, and your payout wallet receives its 75% share in that asset. Keep the same pair and fee throughout quoting, payment and retries.

Paid Pump.fun launch with a SOL or custom pair. Use selfFunded: true to pay from the agent wallet.

curl -X POST https://clawpump.tech/api/v1/launch \
  -H "Authorization: Bearer cpk_…" \
  -H "Content-Type: application/json" \
  -d '{ "agentId": "0d5f…", "symbol": "ALPHA", "description": "…", "imageUrl": "https://…", "selfFunded": true,
        "pumpQuoteMint": "<mint from GET /pump-pairs>", "pumpCreatorFeeBps": 250, "initialBuySol": 0 }'

{
  "status": "launched",
  "mintAddress": "<NEW_TOKEN_MINT>",
  "txHash": "<LAUNCH_TRANSACTION_SIGNATURE>",
  "pumpQuoteAsset": {
    "mint": "<PAIR_MINT_FROM_THE_CATALOGUE>",
    "symbol": "<PAIR_SYMBOL>",
    "decimals": 6,
    "creatorFeeBps": 250
  },
  "meta": { … }
}

• A 402 from this endpoint carries structured self-funding guidance (code, selfFunded.fundWallet, requiredSol). Read it rather than treating 402 as fatal.
• The success response includes payoutWallet: the wallet the fee program registered for this token's creator-fee share. Check it equals what you sent.
• Custom pairs support an optional initialBuySol purchase: the service swaps that SOL into the paired asset for the launch buy. Use 0 (or omit it) for no initial purchase. Locked or vesting allocations are not supported for custom pairs. A successful custom-pair launch includes pumpQuoteAsset with the recorded mint, symbol, decimals and creatorFeeBps.
• Without imageUrl and without an agent avatar the launch fails with "Token image is required: pass imageUrl, or set an avatar on the agent".

Cost discovery for self-funded launches, priced for the selected pair.

curl -H "Authorization: Bearer cpk_…" "https://clawpump.tech/api/v1/launch/self-funded?quoteMint=<mint from GET /pump-pairs>"

{
  "paymentMethod": "sol",
  "quoteMint": "So11111111111111111111111111111111111111112",
  "payTo": "49CfXAr58cCTGJnYsbm16fEsE5JRpdR8QQP8E1ZinGCq",
  "creationFeeSol": 0.00751,
  "defaultDevBuySol": 0,
  "standardCostSol": 0.00751,
  "quoteValidForSeconds": 900,
  "steps": ["…"],
  "meta": { … }
}

• Cost discovery is an estimate. The exact SOL amount for a given launch comes from a preflight: true request, which pins it to your pair and dev-buy choice and issues the signed preflightToken the paid retry must carry. The USDC amount comes from the x402 402.
• Creation is priced live from account rent and transaction fees, with no initial purchase unless requested. For standard SOL pairs, a dev buy adds 0.006 SOL of handling on top of the buy itself. Custom-pair purchase handling is priced separately for the required accounts and swap; use the exact preflight quote when funding either flow.

pump.fun launch that you pay for: SOL from the payout wallet, or USDC via x402. Two calls: get the terms, pay, repeat with the proof.

# SOL, step 1: ask for the quote
curl -X POST https://clawpump.tech/api/v1/launch/self-funded \
  -H "Authorization: Bearer cpk_…" \
  -H "Content-Type: application/json" \
  -d '{ "preflight": true, "name": "Alpha", "symbol": "ALPHA", "description": "…20+ chars…",
        "imageUrl": "https://…", "agentId": "0d5f…", "agentName": "Alpha Scanner", "walletAddress": "7xKX…",
        "pumpQuoteMint": "<mint from GET /pump-pairs>", "pumpCreatorFeeBps": 250, "devBuySol": 0 }'

# SOL, step 2: send exactly payment.amountLamports from walletAddress to payment.payTo

# SOL, step 3: repeat the same body (without preflight) plus the proof
curl -X POST https://clawpump.tech/api/v1/launch/self-funded \
  -H "Authorization: Bearer cpk_…" \
  -H "Content-Type: application/json" \
  -d '{ …same fields…, "txSignature": "5Kd…", "preflightToken": "…" }'

# USDC via x402: send the body with no payment, read the 402, pay with an x402
# client, then repeat the same body with the PAYMENT-SIGNATURE header.

{
  "payment": {
    "method": "sol", "amountLamports": 7510000, "amountSol": 0.00751,
    "payTo": "49CfXAr58cCTGJnYsbm16fEsE5JRpdR8QQP8E1ZinGCq", "payFrom": "7xKX…",
    "validForSeconds": 900, "breakdown": { "creationFeeSol": 0.00751, "devBuySol": 0 }
  },
  "retryWith": { "txSignature": "<signature of that SOL transfer>", "preflightToken": "…" },
  "meta": { … }
}

• SOL flow: POST with preflight: true → 200 with the exact amount, destination and a preflightToken valid for 900 s → send exactly that many lamports from walletAddress to payTo → POST the same body again (without preflight) with txSignature and preflightToken. Amount and window are checked exactly against the quote.
• Pair selection changes the token's trading pair, not the launch payment currency. Include pumpQuoteMint and pumpCreatorFeeBps in the preflight and repeat both unchanged when paying. The signed quote binds them; changing either invalidates it. Successful custom-pair launches include pumpQuoteAsset with the recorded mint, symbol, decimals and creatorFeeBps.
• USDC flow (x402): POST with no payment → 402 with the PAYMENT-REQUIRED header → pay the accepts[0] terms with an x402 client (USDC on Solana mainnet, ClawPump pays the transaction fee) → repeat the same body with the PAYMENT-SIGNATURE header. Settlement happens before the mint; the USD amount is the launch cost at the live SOL price, minimum $1.50.
• After paying, never change the body. Repeat the identical request until it returns 200 or 202: the launch is idempotent on txSignature and the payment is never consumed twice. Retry promptly, since the quote window is 900 s until the service has accepted the payment; once it has (a SELF_FUNDED_WALLET_LOW after paying, or any failure after acceptance) there is no time limit.
• walletAddress is both payer and beneficiary. The token itself is minted and controlled by ClawPump's creator wallet; this wallet only funds the launch and receives the fee share.
• Idempotent on txSignature: a retry after a timeout returns the existing launch instead of minting twice.
• The x402 402 is relayed from the fee program unchanged, headers included. Only the alternatives.sol hint and meta are added by the gateway.

Wallet-funded launch on Robinhood Chain (EVM) via Pons.

curl -X POST https://clawpump.tech/api/v1/launch/pons \
  -H "Authorization: Bearer cpk_…" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6b1c…" \
  -d '{ "agentId": "0d5f…", "symbol": "ALPHA", "description": "…", "logoUrl": "https://…", "payoutWallet": "0x…" }'

• Accepts an Idempotency-Key header. Supply a stable UUID per logical launch so retries do not double-mint. If omitted, one is generated per request and retries are not protected.
• Confirm current Pons / Robinhood Chain launch availability with ClawPump before shipping against this endpoint. It depends on an external chain integration whose status changes independently of this API.

Wallet-funded Uniswap launch via pools.trade.

• Accepts an Idempotency-Key header, same semantics as /launch/pons.
• Fields not listed here are silently dropped. A 402 is relayed with its x-* and WWW-Authenticate headers intact.

Preview a swap route and price impact.

Build an unsigned swap transaction. Same fields as quote, with agent_id required.

• The swap runs through the agent's trading tool chain, which applies ClawPump's safety gates (whitelisting, unverified-token and high-risk checks). A blocked swap returns 403 with a code of policy_denied or security_denied. Only send the acknowledge flags when your own product has surfaced the risk to the end user.
• The response includes normalised aliases alongside the raw payload: unsignedTransaction, inputAmount, outputAmount, priceImpact, expiresAt.

Token price lookup.

{ "mint", "symbol", "name", "price", "currency", "change24h", "volume24h", "marketCap", "liquidity", "source", "updatedAt" }

Search tokens. Jupiter plus the curated list, merged, deduped, verified-first.

{ "query", "recommended", "tokens": [], "sources", "droppedUnverified" }

BTC / ETH / SOL / USDC / USDT spot and 24 h change.

Bitget alpha movers.

• timeframe, sort_by and min_liquidity are accepted but ignored upstream. The data returns unfiltered.

Bitget alpha gems.

• timeframe, types and limit are accepted but ignored upstream.

Static stub.

• Returns a list of protocol names and a note that live APY is not wired up. Do not surface this as real yield data. protocol, min_apy and limit are ignored.

Fixed BTC / ETH / SOL sentiment payload.

• The response is always the BTC / ETH / SOL macro sentiment block regardless of the mint requested. timeframe and period are also ignored.

Currently non-functional. Do not integrate.

• The gateway requires and forwards ?wallet=, but the upstream service requires agent_id and ignores wallet, so every call returns 400. Use GET /agents/{agentId} for the agent's walletAddress, then read balances from a Solana RPC or your own indexer.

List automations for one agent.

{
  "id": "…", "agentId": "…", "name": "…", "description": null, "status": "active",
  "triggerType": "schedule", "actionType": "chat", "runCount": 12,
  "lastTriggeredAt": "…", "createdAt": "…", "updatedAt": "…"
}

Create a price trigger or schedule. The body is forwarded verbatim. Returns 201.

Delete an automation.

{ "success": true }

• There is no update endpoint on v1. To change an automation, delete and recreate it.