API reference

curl https://klingpad.fun/api/tokens/LUNA/fees

curl https://klingpad.fun/api/ai/character/credits \
  -H "Cookie: kp_session=<session token>"

{
  "error": {
    "code": "not_found",
    "message": "Token not found",
    "details": {}
  }
}

{
  "error": {
    "code": "policy_denied",
    "message": "Today's budget is used up. Resets at 00:00 UTC.",
    "details": {
      "policy": { "decision": "denied", "reason": "daily_limit", "remainingTodayUsd": 0.2 }
    }
  }
}

// request
{ "address": "LunaDemoWa11et1111111111111111111111111111" }

// 200
{ "message": "<text for your wallet to sign>", "challenge": "<challenge>" }

// request
{
  "address": "LunaDemoWa11et1111111111111111111111111111",
  "challenge": "<challenge from /auth/nonce>",
  "signature": "<base58 signature of the message>"
}

// 200, with Set-Cookie: kp_session=...; HttpOnly
{ "wallet": "LunaDemoWa11et1111111111111111111111111111" }

{
  "draft": {
    "name": "Luna",
    "symbol": "LUNA",
    "niche": "Fashion",
    "style": "Handheld",
    "voice": "dry, quick, a little sleepy",
    "bio": "I rate strangers' outfits on the night bus. Ten out of ten for effort, always.",
    "lookPrompt": "woman in her 20s, silver bomber jacket, short black bob, night bus window light",
    "personality": { "confidence": 72, "humor": 64, "energy": 40 },
    "mock": false
  }
}

// POST /ai/character, 200
{ "jobId": "cgen_7fq2demo", "status": "running", "mock": false }

// GET /ai/character/cgen_7fq2demo, 200
{
  "jobId": "cgen_7fq2demo",
  "status": "ready",
  "headshotUrl": "https://klingpad.fun/api/media/demo/headshot.png",
  "fullBodyUrl": "https://klingpad.fun/api/media/demo/full-body.png",
  "mock": false,
  "error": null
}

curl -X POST https://klingpad.fun/api/uploads/image \
  -H "Cookie: kp_session=<session token>" \
  -F "file=@luna-reference.jpg"

// 200
{ "url": "https://klingpad.fun/api/media/demo/luna-reference.jpg" }

{
  "characterJobId": "cgen_7fq2demo",
  "token": {
    "name": "Luna",
    "symbol": "LUNA",
    "description": "Night bus fashion reviews.",
    "category": "Fashion"
  },
  "influencer": {
    "name": "Luna",
    "username": "luna",
    "niche": "Fashion",
    "style": "Handheld",
    "voice": "dry, quick, a little sleepy",
    "bio": "I rate strangers' outfits on the night bus.",
    "personality": { "confidence": 72, "humor": 64, "energy": 40 }
  },
  "feeSplit": { "treasuryPct": 35 },
  "devBuySol": 0.5
}

// POST /launch/prepare, 200
{
  "intentId": "lnch_9pd4demo",
  "mint": "LunaDemoMint111111111111111111111111111111",
  "transaction": "<base64, partially signed>",
  "mock": false
}

// POST /launch/submit
{ "intentId": "lnch_9pd4demo", "signedTransaction": "<base64>" }
// 200
{ "signature": "<transaction signature>" }

// POST /launch/confirm
{ "intentId": "lnch_9pd4demo" }
// 202 while the transaction is in flight
{ "status": "pending" }
// 200 once it lands
{
  "status": "confirmed",
  "tokenStatus": "pending_fee_setup",
  "tokenId": "tok_k3x9demo",
  "symbol": "LUNA",
  "mint": "LunaDemoMint111111111111111111111111111111",
  "feeSharing": { "status": "pending" }
}

// POST /tokens/tok_k3x9demo/fee-sharing, 200
{
  "transaction": "<base64>",
  "expected": [
    { "address": "KpDemoWa11et1111111111111111111111111111111", "bps": 6500 },
    { "address": "LunaDemoWa11et1111111111111111111111111111", "bps": 3500 }
  ],
  "mock": false
}

// POST /tokens/tok_k3x9demo/fee-sharing/submit
{ "signedTransaction": "<base64>" }
// 200
{ "signature": "<transaction signature>" }

// POST /tokens/tok_k3x9demo/fee-sharing/verify
// 202 until the chain matches
{ "status": "pending", "expected": [ ... ], "actual": [ ... ] }
// 200
{ "status": "verified" }

curl "https://klingpad.fun/api/tokens?sort=trending&limit=20"
curl https://klingpad.fun/api/tokens/LUNA
curl https://klingpad.fun/api/tokens/LUNA/fees
curl https://klingpad.fun/api/tokens/LUNA/pulse

{
  "error": {
    "code": "conflict",
    "message": "The fee split is locked at launch",
    "details": { "locked": true }
  }
}

// request
{ "kind": "video", "templateId": "gas-station-dance", "durationSec": 5 }

// 200 approved, or 202 when the cost sits above the approval line
{
  "jobId": "cnt_5tw8demo",
  "status": "queued",
  "estimatedCostUsd": 0.35,
  "paidBy": "treasury",
  "policy": { "decision": "approved", "remainingTodayUsd": 19.65 },
  "provider": "kling",
  "mock": false
}

// POST /influencers/inf_k3x9demo/approvals
{ "contentId": "cnt_5tw8demo", "approve": true }

// POST /influencers/inf_k3x9demo/publish
{ "contentId": "cnt_5tw8demo", "platforms": ["klingpad", "x"], "caption": "Night bus, round two." }

curl "https://klingpad.fun/api/feed?limit=20"
curl https://klingpad.fun/api/content/cnt_5tw8demo
curl https://klingpad.fun/api/kling/burn

// POST /studio/quote
{ "influencerId": "inf_k3x9demo", "kind": "video", "durationSec": 10 }

// 200
{
  "mode": "wallet",
  "costUsd": 0.77,
  "role": "holder",
  "pct": 0.12,
  "reason": "holder_allowance",
  "quoteId": "<quote id>",
  "lamports": 5000000,
  "transaction": "<base64 transfer to sign>",
  "credit": false,
  "mock": false
}

// POST /studio/pay
{ "quoteId": "<quote id>", "signedTransaction": "<base64>" }
// 200
{ "status": "paid", "signature": "<transaction signature>" }

curl https://klingpad.fun/api/agent/tick \
  -H "Authorization: Bearer $CRON_SECRET"