Sell to agents,one asset at a time.

Every call carries an agent key in the x-api-key header. Two ways to get one: DM /apikey to @thememeginebot (instant), or open the dashboard's API tab and hit Generate key. Keys are shown once — store them securely.

curl https://bot.plunderandriffle.com/api/agent/assetring/pricing \
  -H "x-api-key: prl_agent_YOUR_KEY"

Missing or invalid keys return 401. Rate limits apply per key — pricing 60/min · create 10/min · status 60/min · check 20/min.

Every route below charges from the same table. Pay with x-api-key credits or per call over x402 in USDC. MP4 assets are priced in USD ($0.25) and quoted in SOL at the live rate; the SOL amounts in the examples are illustrative.

1. 01
   POST /agent/assetring/jobsGenerate the free preview, get a unique lamport quote.
2. 02
   PaySend exactly that amount to the treasury wallet — plain transfer, no memo needed.
3. 03
   POST …/checkThe sweep verifies your deposit on-chain and claims it atomically.
4. 04
   PollOnce status is "DELIVERED", the final MP4 is in mp4Url.

The unique-amount quote is the double-redemption guard: one signature unlocks exactly one asset, ever. Quotes expire after 24h — create a fresh job if yours lapses.

Pass a callbackUrl when creating a job and we POST the finished MP4 to you the moment it delivers — no polling loop needed. Optionally supply your own webhookSecret (16+ chars); omit it and we generate one, returned exactly once in the create response.

POST https://yourapp.com/hooks/apiring
Content-Type: application/json
User-Agent: PlunderRiffle-AssetRing/1.0
X-Apiring-Signature: sha256=<hex HMAC-SHA256 of the raw body with your webhookSecret>
X-Apiring-Event: job.delivered
X-Apiring-Job-Id: <jobId>

{ "event": "job.delivered", "jobId": "…", "status": "DELIVERED",
  "format": "slideshow", "mp4Url": "https://…/final.mp4",
  "paid": true, "deliveredAt": "…", "attempt": 1 }

• Verify the signature: HMAC-SHA256 of the raw request body keyed with your webhookSecret.
• Delivery is at-least-once — treat replays as no-ops (key on jobId).
• Failures are retried by a background sweeper every 60s until acknowledged (2xx).
• Render failures push event: "job.failed" with error — the payment stays bound to the job.
• callbackUrl must be a public http(s) URL — loopback, private and internal hosts are rejected.

Prefer prepaid credits? The same key also powers the credit API — top up with USDC or Stripe.

The same meme engine behind every branded bot. One call returns a live meme page (plus a PNG for carousels). Spends credits from the same key balance; failures are refunded. Kinds: image · carousel · confession · hottake · reply (1 credit) · hybrid (2).

curl https://bot.plunderandriffle.com/api/agent/brands/memes \
  -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"brief":"when the API key finally works on the first try","kind":"image"}'

# → { "success": true,
#     "meme": { "kind": "image", "url": "https://…here.now/…", "imageUrl": null, "title": "…" },
#     "brand": { "key": "acme", "name": "Acme", … },
#     "creditCost": 1, "creditsRemaining": 9 }

Every branded bot on the meme engine is programmatically addressable by key. AI agents can query all available registered brand bots using GET /agent/brands, or target a specific bot by setting "brand": "<key>" in the request body. If you haven't registered a bot, you can pass an ad-hoc brandProfile to generate content using your company's custom voice, hashtag, and token ticker.

curl -s https://bot.plunderandriffle.com/api/agent/brands \
  -H "x-api-key: $KEY"

# Response:
# {
#   "success": true,
#   "brands": [
#     { "key": "acme", "name": "Acme", "token": "$ACME", "hashtag": "#ACME", "botUsername": "AcmeMemeBot", "telegramUrl": "https://t.me/AcmeMemeBot" },
#     { "key": "pepe", "name": "PepeBot", "token": "$PEPE", "hashtag": "#PEPE", "botUsername": "PepeMemeBot", "telegramUrl": "https://t.me/PepeMemeBot" }
#   ],
#   "custom": { "field": "brandProfile", "shape": { "name": "string", "voice": "string", "hashtag": "#TAG", "token": "$TICKER" } }
# }

# Target a specific registered brand bot by key
curl https://bot.plunderandriffle.com/api/agent/brands/memes -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"brief":"gas fees at 3am","kind":"carousel","brand":"pepe"}'# Ad-hoc brand persona (no Telegram bot provisioned required)
curl https://bot.plunderandriffle.com/api/agent/brands/memes -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"brief":"Monday standups","brandProfile":{"name":"Acme","voice":"dry, self-aware B2B humor","hashtag":"#ACME","token":"$ACME"}}'

# POST /agent/content — the same engine behind every brand bot's
# "# BRAND CONTENT" Telegram menu: copy prebuilt with the brand's
# voice, Ralph's angle brain, and the network what-is-working playbook.
# Categories: meme · shitpost · tweet · linkedin · joke · promo ·
#             video · reaction · unhinged   (default: meme, 1 credit)

curl https://bot.plunderandriffle.com/api/agent/content -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"category":"tweet","topic":"ship fast, revert faster","brand":"pepe"}'

# → { "success": true,
#     "content": { "category": "tweet", "title": "…", "copyText": "…",
#                  "suggestedCaption": "… #PEPE", "hashtags": ["#PEPE"] },
#     "brand": { "key": "pepe", "name": "PepeBot", … },
#     "creditCost": 1, "creditsRemaining": 9 }

# Works with ad-hoc personas too:
curl https://bot.plunderandriffle.com/api/agent/content -H "x-api-key: $KEY" -H "Content-Type: application/json" \
  -d '{"category":"linkedin","brandProfile":{"name":"Acme","hashtag":"#ACME"}}'

Each brand bot's public feed, leaderboard, and featured content can be queried via /brands/<key>/recent, /leaderboard, and /featured. Telegram bot administrators can provision and manage specific brand bots dynamically via /admin → Brands.

200

Success — check may still report paid: false if no matching deposit has landed yet.

400

Validation — bad format, missing input.

401

Missing or invalid agent key.

404

Job not found, or it belongs to another key.

429

Rate limited.

502 / 503

Generation or quote allocation failed — retry safely.