← Articles
Cherry Portal: chat embed SDK and REST API logo
cherry

Cherry Portal: chat embed SDK and REST API

· SEP 25, 2026 ·
Read
Share

iframe embed.cherry.fun. Telegram Bot API stays.

devrels.xyz/a/331

Cherry Portal is the self-service developer surface for the Cherry ecosystem. Cherry is a wallet-to-wallet messenger (web, iOS, Android, Solana Seeker). Started on Solana. Also Base, Ethereum, BNB Smart Chain, Robinhood Chain. Portal: build mini apps, embed chat, run bots. Free.

Two surfaces. The Chat Embed SDK puts a room on your site. The Cherry API creates rooms and moderates from your backend. They compose: create with the API, mount with the SDK. Official X @cherrydotfun. Telegram t.me/cherrydotfun. Our Telegram Bot API piece stays.

Embed SDK

Package @cherrydotfun/chat-embed-sdk, current 0.1.7. Class CherryEmbed. Iframe default https://embed.cherry.fun. If you set CSP, allow frame-src https://embed.cherry.fun. Host pages never set an API base. Quickstart is wallet-only SIWS, about five minutes, no backend. Demo: cherry.fun/chat-embed-example.

bash
npm install @cherrydotfun/chat-embed-sdk

SDK is DOM-only. React Native / Flutter: WebView host page, not embed.cherry.fun as the top document. Auth modes: wallet-only, app-trusted+wallet (HS256 JWT with claims sub and app_id only, 5m), app-trusted. App secret stays on the server.

Cherry API

OpenAPI 3.1.0, title Cherry API 1.0.0. Server https://api.cherry.fun. Copy one opaque token from the portal. Do not assemble it.

Key types
KeyBase
Project cherry_sk_https://api.cherry.fun/api/v1/apps
Bot cherry_bot_https://api.cherry.fun/api/v1/bots
bash
curl https://api.cherry.fun/api/v1/apps/me \
  -H "Authorization: Bearer <project-key>"

Rooms: POST /groups. Spec: /openapi.json. cha_ is deprecated legacy. Rate limit per app, rolling: 600/min, 50,000/day. 429 with Retry-After. Agent index: /llms.txt.

Resources

Keep reading

Get new articles in your inbox

Technical deep-dives on Solana tooling, infrastructure, and ecosystem. No noise.

Cherry Portal: chat embed SDK and REST API | devrels.xyz