# OhMy.xin User Guide — Full Text > The complete text of the bilingual (简体中文 / English) OhMy.xin user guide, for LLM ingestion. Every page is included with its canonical URL. > > This file covers the end-user guide: joining circles, memberships and payments, chatting modes, tipping, Oh My Luck campaigns, and the circle-creator console handbook. The open platform's developer documentation is in the `open-platform` section below, and its machine-readable contract is served separately as an OpenAPI 3.1 spec at https://docs.ohmy.xin/openapi.json. > > A page index with one-line descriptions is available at https://docs.ohmy.xin/llms.txt. ## English ### Start here / 快速开始 #### Create your own circle > From creating a Mixin bot to finishing the connect wizard — launch your paid community. > > Source: https://docs.ohmy.xin/en/start-here/create-a-circle/ After this page you will have a circle running on OhMy.xin with the basics set up. ## Before you start - A Mixin account, and a computer (you'll download and upload a file). - About 30 minutes. - A safe place to keep your bot's credentials file — it is the bot's key; never share it with anyone. ## Part 1: register the bot and connect it (about 10 minutes) This is the one fiddly part: you collect **two things** on Mixin and hand them to OhMy.xin. Click through it below once, then do it for real. For what each item is and how to fix common errors, see [Create a bot on Mixin](/en/creator-guide/create-your-bot) and [Connect to OhMy.xin](/en/creator-guide/connect-to-ohmyxin). ## Part 2: open for business 1. Follow the [launch checklist](/en/creator-guide/launch-checklist) to finish the basics: welcome message, circle intro, and chat mode. 2. Set up membership plans and pricing, then share your invite link and welcome your first member. ## What happens next - After a member pays, the platform immediately sends your share (minus the 10% platform fee and any inviter bonus) straight to your Mixin wallet, usually within seconds to minutes. - The **Today** dashboard in the console shows your circle's operating status at a glance. ## If something goes wrong - **Credentials fail validation** — make sure the keystore and the Client Secret come from the same bot and are both the newest ones; see [Connect to OhMy.xin](/en/creator-guide/connect-to-ohmyxin#if-something-goes-wrong) for more cases. - **Bot can't be connected** — a bot can only power one circle; if it was used by another circle before, disconnect it there first. ## Related pages - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) - [Creator guide](/en/creator-guide/) - [FAQ](/en/reference/faq) --- #### Join a circle > From an invite link to your first message — the complete steps. > > Source: https://docs.ohmy.xin/en/start-here/join-a-circle/ After this page you will have gone from receiving an invite link to sending your first message in a circle. ## Before you start - A phone with [Mixin Messenger](/en/mixin-basics/what-is-mixin) installed and an account created. - A circle invite link, usually shared in a group chat or by a friend. - For paid circles: an accepted asset (such as USDT) in your Mixin wallet. ## Steps Tap through it on the phone below — each step shows the screen you'll actually see. ## What happens next - The circle reminds you before membership expires; some circles offer a renewal discount — the renewal page shows the exact price. - You can check your membership status and transfer records any time in the **Mine** tab. ## If something goes wrong - **Membership not active after paying** — wait a few seconds and refresh; if it still isn't, look up the payment with its transfer reference on the order page, or contact the circle owner. - **"Please upgrade your Mixin Messenger"** — receiving red packets, tips, or prizes needs a recent app version; update from the app store. - **Invite link doesn't open** — make sure Mixin Messenger is installed; if not, [install it first](/en/mixin-basics/what-is-mixin). ## Related pages - [What is OhMy.xin?](/en/start-here/what-is-ohmyxin) - [Member guide](/en/member-guide/) - [FAQ](/en/reference/faq) --- #### New here? Pick your path > Want to join a circle, or create your own? What each path takes and costs, all in one place. > > Source: https://docs.ohmy.xin/en/start-here/pick-your-path/ There are two kinds of people on OhMy.xin: people who **join circles** and people who **create circles**. Answer two or three questions and jump straight to the page you need. Want to compare what each path takes and costs first? Read on. ## I want to join a circle For you if you want to read posts, chat, and join in inside a circle. - **What you need** — a phone with [Mixin Messenger](/en/mixin-basics/what-is-mixin) installed. - **What it costs** — free circles cost nothing at all; paid circles charge the plans the circle owner sets, usually monthly or yearly, paid with assets from your Mixin wallet. - **How long it takes** — about ten minutes from an invite link to your first message. → Follow the [Join a circle](/en/start-here/join-a-circle) path. ## I want to create a circle For you if you have content or a community and want to run your own paid space. - **What you need** — a Mixin account and about 30 minutes to create your circle and connect it. - **What it costs** — creating and running a circle is free; the platform takes a 10% service fee on each membership or member tier order. The optional [Circle VIP](/en/reference/pricing-and-fees) is prepaid monthly (with 1/3/12-month plans) and unlocks extras like premium layouts. - **How long it takes** — you can be live the same day, welcoming your first paying member. → Follow the [Create your own circle](/en/start-here/create-a-circle) path. ## Still deciding? Start with [What is OhMy.xin?](/en/start-here/what-is-ohmyxin), or see [Pricing and fees](/en/reference/pricing-and-fees) for the exact numbers. --- #### What is OhMy.xin? > A community platform inside Mixin Messenger — posts, chat, paid membership, tipping, and activities. > > Source: https://docs.ohmy.xin/en/start-here/what-is-ohmyxin/ OhMy.xin is a community platform that runs inside [Mixin Messenger](/en/mixin-basics/what-is-mixin). We call these communities **circles**: an online space carried by a bot, with posts, chat, and a membership system. A typical circle includes: - **Posts and articles** — content published by the circle owner; some of it is members-only. - **Chat** — depending on the circle's settings, you can ask questions, discuss, or just listen to broadcasts. - **Membership** — free or paid, it decides what you can see and do. - **Tipping, red packets, lotteries** — activities you join with assets from your Mixin wallet. ## Do I need to understand crypto? No. All you need is Mixin Messenger — signing up and chatting work like any messaging app. Your wallet only comes into play when you pay for a membership or join an activity, and we explain each step right there. ## Is it safe? - Sign-in happens through your Mixin account; OhMy.xin never touches your wallet keys. - Owner income is never held on the platform — as soon as an order completes, the owner's share is sent straight to the owner's own Mixin wallet as a Mixin Safe transfer. - Be wary of anyone asking for your keystore file or recovery phrase — official support never will. ## Related pages - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) - [Join a circle](/en/start-here/join-a-circle) - [Create your own circle](/en/start-here/create-a-circle) ### Mixin basics / Mixin 基础 #### Bots: how circles work > Every circle is a bot conversation — the profile page is the circle's front door. > > Source: https://docs.ohmy.xin/en/mixin-basics/bots/ Every circle runs on a Mixin bot. Everything you do with a circle — reading posts, chatting, joining as a member — happens in that bot's conversation. ## The bot is the circle's front door - Tap the bot's avatar to open its **profile page**: that's where you browse posts, replays, and announcements, and where you start a chat or join the circle. - In the conversation, the bot delivers posts to you and handles your commands (for example, send `/help` to see the help). - The bot's name and avatar are the circle's name and avatar, chosen by the circle owner. ## Joining the bot is not the same as becoming a member Opening the chat only gets you through the door. In a free circle, you can tap the **Join — it's free** button and become a member right away; in a paid circle, you need to [buy a membership](/en/member-guide/membership) to see locked content. And even if you never join, you can still browse the public content. ## How people find circles Circles travel through **invite links** — someone shares a link in a group chat or with a friend, and tapping it opens the bot's profile page. ## Related pages - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) - [Join a circle](/en/start-here/join-a-circle) - [What is OhMy.xin?](/en/start-here/what-is-ohmyxin) --- #### Owner income and payouts > How a circle owner's income arrives — automatically sent to your Mixin wallet after every payment, nothing to withdraw. > > Source: https://docs.ohmy.xin/en/mixin-basics/owner-payouts/ A circle owner's income is never held on the platform: as soon as each membership or member tier order completes, OhMy.xin immediately sends your share (order total − 10% service fee − any inviter bonus) straight to your own Mixin wallet as a Mixin Safe transfer, usually within seconds to a few minutes. Tips, red packets, and prizes reach their recipients' Mixin wallets the same way. ## What you need to do Nothing — there's no balance, no withdraw button, and no wallet to configure. Once the money arrives, it's in your own Mixin wallet, just like a transfer from a friend. ## When you'll notice it - **When an order settles** — each payment triggers an automatic transfer; you can verify it in your Mixin transfer history. - **When you receive a red packet, a tip, or a prize** — those transfers are sent by the platform too. If your Mixin Messenger is outdated, you'll see "Please upgrade your Mixin Messenger"; update from the app store and reopen the app to claim. ## Related pages - [Pricing and fees](/en/reference/pricing-and-fees) - [Staying safe on Mixin](/en/mixin-basics/staying-safe) - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) --- #### Paying on OhMy.xin > How to pay membership fees and tips — the payment page, arrival times, and transfer records. > > Source: https://docs.ohmy.xin/en/mixin-basics/paying-on-ohmyxin/ Paying on OhMy.xin is just a Mixin transfer: pick the content and the amount, confirm, and it usually lands in seconds. ## The payment flow 1. On the payment page, pick a plan (or an amount) and an asset. 2. Tap pay, and Mixin Messenger opens a transfer confirmation screen; you can also scan the QR code on the page. 3. After you confirm, wait a few seconds — the payment status updates on its own. 4. Once the payment goes through, you can find the order and transfer records on the **Mine** tab, and check this transfer any time with its Trace. ## Two handy tips - **A payment page is usually valid for 15 minutes.** If it expires, just start the payment again — you won't be charged twice. - **Don't want to use an asset from the list?** Choose "Pay with other assets" to pay through Mixpay with a different asset, converted at the live exchange rate. ## Who gets the money --- #### Staying safe on Mixin > Three rules that keep you clear of nearly every scam. > > Source: https://docs.ohmy.xin/en/mixin-basics/staying-safe/ Money in Mixin is real money, so look after it the way you'd look after cash. The good news: three rules will steer you clear of almost every scam. ## The three rules - **Never share anything key-related** — credentials files, recovery phrases, private keys, verification codes: anyone who asks for these is a scammer, no exceptions. - **Official support never comes asking** — OhMy.xin and Mixin will never message you first to ask for transfers, keys, or personal details. If you get such a message, ignore it and report it. - **Check who you're paying before you send** — payments only happen in flows started from an OhMy.xin payment page; ignore payment requests from strangers. ## Watch-outs inside circles - **Use the official way in** — join a circle only through its invite link (shared by the owner or a member), which opens the circle's own bot, and pay only on the payment page inside the circle's bot conversation. - **"Insider tips" and "guaranteed returns" are red flags** — especially in trading circles, be wary of anything that promises profits. - **Only upgrade from the app store** — when a transfer needs a newer Mixin Messenger, update from the official app store; never tap an install package shared in a chat. ## Practice: safe or scam? Put the rules to work on five messages a circle member might get. ## A special note on credentials files Circle owners who create a bot receive a credentials file (keystore). It holds all of the bot's powers. Use it only in the upload step of OhMy.xin's connect wizard, and never send it to anyone — including people who claim to be official. ## Related pages - [Your Mixin account and Mixin ID](/en/mixin-basics/your-mixin-account) - [Owner income and payouts](/en/mixin-basics/owner-payouts) - [Bots: how circles work](/en/mixin-basics/bots) --- #### Wallets and assets > What the Mixin wallet is, which assets it holds, and how you pay with them. > > Source: https://docs.ohmy.xin/en/mixin-basics/wallet-and-assets/ Mixin Messenger has a wallet built in — it's where your assets live and where you send and receive money. You'll find it on the **Wallet** tab in the app. ## Assets you'll see in circles Assets supported on OhMy.xin include USDT, PUSD, USDC, BTC, ETH, XIN, DOGE, EOS, and BOX. Which ones a circle accepts is up to the circle owner — they're listed for you to pick from when you pay. - Not sure which to choose? **USDT** is the most common pick, and its price stays steady. - You can swap between assets right inside the Mixin wallet. ## Where the money comes from - Someone transfers it to you, or you withdraw it from an exchange to your Mixin wallet. - Red packets, tips, and refunds you receive land in your wallet too. ## What happens when you pay When you pay, you confirm a Mixin Safe transfer on the payment page; the money first lands on the OhMy.xin platform wallet, and the platform then forwards the payee's share (such as the circle owner's) in real time, usually within seconds. For the full flow, see [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin). ## Related pages - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) - [Pricing and fees](/en/reference/pricing-and-fees) --- #### What is Mixin Messenger? > Where circle life happens — a phone app that combines chat with a wallet. > > Source: https://docs.ohmy.xin/en/mixin-basics/what-is-mixin/ Mixin Messenger is a phone chat app ([download at messenger.mixin.one](https://messenger.mixin.one/), iOS and Android). It looks like any messaging app, but it has a built-in wallet. OhMy.xin circles run inside Mixin because: - **Sign-in is your identity** — one tap with your Mixin account, no new registration, no password. - **Payments are transfers** — membership fees, tips, and red packets are wallet transfers that usually settle in seconds. - **A circle is a conversation** — every circle is carried by a Mixin bot; tap the bot's avatar to browse posts and replays. ## Three concepts you will meet - **** — your user identifier; others can find you by it. - **Wallet** — where assets like USDT and BTC live; payments are deducted from here. - **Safe transfers** — a circle's payments and tips move through Mixin's safe-transfer mechanism, usually arriving within seconds to a few minutes. ## Related pages - [What is OhMy.xin?](/en/start-here/what-is-ohmyxin) - [Glossary](/en/reference/glossary) --- #### Your Mixin account and Mixin ID > What your phone number and Mixin ID are, and how people find you. > > Source: https://docs.ohmy.xin/en/mixin-basics/your-mixin-account/ Sign up with a phone number and you have a Mixin account — it's your login identity and the entrance to your wallet. ## Three identifiers, and what each one does - **Phone number** — used to sign up; others can't see it by default. - **Mixin ID** — your unique numeric identifier. You can view it on your profile page. People search for it to find you. - **UUID** — a random string the system uses internally. You don't need to remember it or share it. ## Where you'll meet it on OhMy.xin - Signing in to OhMy.xin uses your Mixin account authorization — no extra sign-up, no new password. - A circle's introduction page shows its description and member count; joining and paying all happen inside the circle's bot, entered through the owner's invite link. ## Keep your account safe - Never hand out verification codes, passwords, or credentials files (keystores) — [official support will never ask for them](/en/mixin-basics/staying-safe). - Before switching to a new phone number, update the binding in Mixin settings first. ## Related pages - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) - [Staying safe on Mixin](/en/mixin-basics/staying-safe) - [Glossary](/en/reference/glossary) ### Member guide / 会员指南 #### Buying & renewing membership > Pick a plan, pay, check your expiry date — the full life of a membership. > > Source: https://docs.ohmy.xin/en/member-guide/membership/ A membership is billed on the plans the circle owner sets. This page covers picking a plan, paying, and what to do when it expires. ## Pick a plan A circle uses one of these two pricing styles: - **Fixed price** — a single price and duration (yearly or monthly). - Subscription plans — several named plans to choose from, like Monthly or Yearly, each with its own duration and price. Subscription plans can come with an intro price: your first purchase costs less than the standard price, and renewals return to full price. Fixed price has no intro price. Once you've picked, pay as described in [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) — it takes effect within seconds. ## Member tiers (Pro content) Some circles also sell **member tiers**: join free or paid as usual, then buy a tier separately to unlock deeper content. Find it in the **Member tier** section of the circle's membership page, or on the unlock card attached to locked content. - A tier only unlocks content; it never changes your role, membership, chat access, or red packet and lottery eligibility. - When a tier expires, tier-only content locks again and nothing else changes. The bot messages you to renew, and you can buy again at any time. - You cannot buy the tier twice while it is active; wait for it to expire. - If your circle membership lapses first, renew it before you can read tier content, even while the tier is still valid. Your remaining tier time is preserved. ## Renewals come with a discount The circle reminds you to renew before your membership expires. Many circles give existing members a renewal discount, and the renewal page shows the discounted price up front. Renewal time stacks on top of your current expiry date, so no remaining days go to waste. ## What happens when it expires When a membership expires you become an [expired member](/en/member-guide/joining): membership content locks again, but your profile and activity history are kept. Renew any time and everything comes back instantly. ## Walk the lifecycle once The expiry math is easiest to believe once you have pushed it around yourself. The lab below starts by joining a paid circle with a 7-day trial: buy during the trial (watch the intro price and which day the term starts from), then skip time and renew once before expiry and once after — renewing early stacks the time, buying after a lapse restarts from the purchase day and does not backfill the gap. Switch to the fixed-price style to see that the renewal discount applies only while you are still a member. ## Two more things worth knowing - **Gifted time** — the circle owner can gift membership time to members directly; when it arrives, your expiry date extends automatically. - **Check status and records** — the **Mine** tab shows your expiry date and all your orders at any time; each order can be matched to its Mixin transfer by its Trace. ## If something goes wrong - **Membership didn't activate after paying** — wait a few seconds and refresh. If it still hasn't, look up the payment with its Trace on the order page, or contact the circle owner. - **Want to switch plans** — just buy the new plan; the time stacks automatically. If you have questions about the price difference, contact the circle owner. ## Related pages - [Joining: free, paid & trials](/en/member-guide/joining) - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) --- #### Chatting in a circle > Who sees your messages under each of the four chat modes, and how the team's messages reach you. > > Source: https://docs.ohmy.xin/en/member-guide/chatting/ The circle owner decides how conversation works. When you join or the mode changes, the bot sends you a private message telling you the current chat mode. There are four: ## Default mode (the default) In Default mode, only the circle owner, admins, and lecturers see your messages; they reply by quoting you. Other members can't see what you say. A good fit for circles where you mostly listen and ask privately. ## Broadcast mode In Broadcast mode, messages from the team are pushed to every member; what you send stays visible to the team only. Made for announcement and news circles. The previous day's broadcasts are usually tidied into a replay. ## Lecture mode In Lecture mode, messages from the team reach everyone, and the whole session is recorded as a replay you can watch afterwards. Questions may be closed at the start — the bot will tell you once the host opens them, so hold off until then. ## Group mode In Group mode, every member can speak and reply to each other — the circle becomes one big group chat. Available only to circles with Circle VIP. Messages may be rate-limited and filtered. ## Try it yourself The simulator below recreates the four modes **from your seat**: the three phones are you, the owner Leo, and fellow member Bob. Switch to a mode, tap a button under any phone to send a message, and watch who receives it and who gets "Not received" — once you have tried it, you don't need to memorize the differences. ## Chat inside a live room If the circle is live, the room's chat follows the same mode: members see the same reach as in circle chat, and the composer explains why when they cannot post. When the host switches modes, the room's chat refreshes automatically. ## Two things worth knowing - **Anonymous mode** — some circles let members speak anonymously: your messages go out under an anonymous identity, and no one sees your real account. The circle owner and admins are always named, and admins can verify who you are if you break the rules — they just won't say so publicly. - **Sending pace** — if you message too quickly, the bot will tell you that you are sending messages too frequently and to rest for a moment. Just wait a little and carry on. ## Related pages - [Posts, votes, questions & articles](/en/member-guide/posts-and-articles) - [Watching lives and replays](/en/member-guide/live) - [Your account: profile, Spark & leaving a circle](/en/member-guide/your-account) --- #### Circle home pages: the four layouts > Classic, Story Hub, Community Hub, Trading Hub — what your circle looks like is up to the circle owner. > > Source: https://docs.ohmy.xin/en/member-guide/layouts/ A circle's home page comes in four layouts. The circle owner picks one — tap through them to see what each looks like. In Story Hub you can follow sources to build your own timeline — see [Story subscriptions](/en/member-guide/story-subscriptions). In Trading Hub, some paid content unlocks with an invite code or a member tier. ## Trading Hub: managing strategies If you are the circle's owner or an admin, you can manage strategies right from the member site: the "New strategy" button in the strategies area of the home page opens a form for the symbol, direction (long / short), entry / target / stop-loss prices, and an optional note. Publishing puts the strategy live immediately and notifies subscribed members; you can also lock a strategy behind an invite code or point it at a member tier. Each strategy card's menu follows its state: a running strategy can be edited, settled at target, stopped out, cancelled, or deleted; a settled one can be edited or deleted. Settling and cancelling both notify subscribers, and a cancelled strategy disappears from members and subscriber circles. ## About unlocking Story Hub and Trading Hub are [circle VIP](/en/reference/pricing-and-fees) layouts — if you can see them, the circle owner has turned them on. The other two layouts are open to every circle. ## Related pages - [Buying & renewing membership](/en/member-guide/membership) - [Posts, votes, questions & articles](/en/member-guide/posts-and-articles) --- #### Joining: free, paid & trials > Visitor, follower, member, expired member — the circle roles at a glance, and what each one takes. > > Source: https://docs.ohmy.xin/en/member-guide/joining/ Your role in a circle decides what you can see and do. This page helps you tell the roles apart and shows how to move up to the one you want. ## The four roles - **Visitor** — not in the circle yet; you can only see public content. - **Follower** — follow a circle for free: read public posts and announcements, and receive the circle owner's broadcasts. - **Member** — a full part of the circle: read membership content, chat in the circle, and join red packets, lotteries, and other activities. - **Expired member** — what you become when a membership runs out. Your profile and history stay intact, and a renewal restores everything instantly. ## Joining a free circle A free circle's home page has a **Join — it's free** button. Tap it and you're a member — no payment at any point. Free entry does not mean everything is free: some circles also sell a member tier, which you can buy after joining to unlock deeper content — see [Buying & renewing membership](/en/member-guide/membership). ## Joining a paid circle 1. Open the circle's unlock hint or plan page and pick a plan. 2. Complete the payment as prompted (see [Buying & renewing membership](/en/member-guide/membership)). 3. Membership takes effect within seconds, and all membership content opens up. ## What is a trial? Some paid circles offer a **trial**: tap the trial button on the plan page and try the circle free for a set number of days, with membership content open the whole time. A trial never charges you automatically — when it ends, membership content locks again, and you buy a plan manually to keep access. Circles with a trial show the number of trial days on their plan page. ## If something goes wrong - **You paid but you're still a follower** — wait a few seconds and refresh. If it still hasn't kicked in, look up the payment with its Trace on the order page, or contact the circle admin. - **Content locked again after the trial?** — that's expected: a trial never auto-charges. Buy a plan to continue. ## Related pages - [Buying & renewing membership](/en/member-guide/membership) - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [New here? Pick your path](/en/start-here/pick-your-path) --- #### Member guide > Everything a circle member needs — joining, paying, chatting, activities, and your account. > > Source: https://docs.ohmy.xin/en/member-guide/ Everything circle members (including just-looking visitors) need, collected in one place. [Screenshot: A circle home page in the Classic layout.] ## In this section - [Joining: free, paid & trials](/en/member-guide/joining) - [Buying & renewing membership](/en/member-guide/membership) - [Your circle home: a tour of the four layouts](/en/member-guide/layouts) - [Posts, votes, questions, and articles](/en/member-guide/posts-and-articles) - [Chatting in your circle](/en/member-guide/chatting) - [Watching lives and replays](/en/member-guide/live) - [Tipping posts and people](/en/member-guide/tipping) - [Red packets, lotteries, and quizzes](/en/member-guide/luck) - [Story subscriptions](/en/member-guide/story-subscriptions) - [Your account: profile, Spark, and leaving](/en/member-guide/your-account) Not sure where to start? Read [Join a circle](/en/start-here/join-a-circle) first. --- #### Posts, votes, questions & articles > What you'll find in the timeline, and how to like, comment, vote, and ask a question. > > Source: https://docs.ohmy.xin/en/member-guide/posts-and-articles/ Most of a circle's content lives in the timeline. This page walks through the kinds of content you'll meet and how to take part. ## Posts: likes and comments - Tap **Like** to show you enjoyed a post; tap again to undo. - Reply to the author or other members in the **comments**; you can't edit or delete your own comments — contact the circle admin if one needs to be removed. - Authors can edit a post at any time — an Edited mark shows afterwards — and can delete their own posts. - Some circles let members post too (the circle owner sets who can post). A post can carry images, or a single video. ## Vote posts The author runs a vote where you pick one option or several, with a deadline anywhere from 1 hour to 30 days. Once voting closes, you can see who voted for each option. Some vote posts are also lottery posts: voting automatically enters you in the draw. ## Ask a question In circles with questions turned on, every post has an **Ask Question** button underneath. Only you and the author can see a question while it waits for an answer — it stays out of the timeline. When answering, the author chooses **public** (everyone can see it) or **private** (only you). Track your history under My Questions / My Answers. ## Articles Articles are long-form pieces published by the circle owner or a lecturer, pushed to you as soon as they go out. Some are grouped into collections. Like posts, articles come with visibility levels: public, Trial, members only. If the circle sells a member tier, an article can also be tier-only. ## Tier-gated content If the circle sells a member tier, some posts, articles, strategies, or public answers are marked tier-only. Without the tier you see a teaser and an unlock card; buying the tier opens the full text immediately. A tier only unlocks content — it never changes your role, membership, or chat and activity eligibility. See [Buying & renewing membership](/en/member-guide/membership). ## Invite-code-gated content Some circles (mostly Trading Hub ones) carry posts, strategies, or articles marked "Unlock with inviter code". A gated article still shows its title and opening, tagged "Invitation code required"; a gated post or strategy shows only a locked cover in the timeline. Either way the body opens only to members invited by one of the circle's designated inviters. To unlock: --- #### Red packets, lotteries & quizzes > Your guide to Oh My Luck — grab red packets, draw for a win, and answer quizzes for a share of the prize pool. > > Source: https://docs.ohmy.xin/en/member-guide/luck/ The circle owner runs promotions called activities: red packets, verifiable lotteries, quizzes, and Twitter Follow tasks. They all run inside **Oh My Luck** — tap an activity card in the circle to take part, or browse them in the Oh My Luck bot. ## Grabbing a red packet 1. Open the red packet card and tap **Open** (enter the claim code first if there is one). 2. The money lands straight in your Mixin wallet. 3. One grab per person; whether it's a lucky-draw or an even split is up to whoever sent it. Common limits: **new members only** (people who joined for the first time in the last 24 hours), **a Spark level**, or **Rewards invitees** (invited into the circle and verified via Mixin Rewards). If you don't qualify, the page says why. When a red packet expires, whatever is left goes back to the sender. ## Verifiable lottery 1. Tap **Shake for your stick** and you get a number (your stick number). 2. When the draw time comes: after every stick number is sealed, the winning entries are worked out using the public drand randomness beacon (published by the League of Entropy). 3. The results page carries the full proof: the beacon value, the algorithm, every stick number and every winner — you can replay the whole verification in your browser with one click. You don't have to trust anyone. 4. Entries close 1 minute before the draw; winnings move to your Mixin wallet automatically. ## Quiz Submit your answers within the time limit; your score is how many you got right. The rules are spelled out before the quiz starts: what share of the prize pool goes to perfect scores and what share to the top N, with ties broken by who submitted first. The organizer settles the quiz after it ends, and rewards go out automatically then. ## Twitter Follow task Follow the target account on X as prompted, then come back and sign up. Note that **the platform doesn't check whether you actually followed** — signing up is just a record. If the organizer confirms success, the prize pool is split evenly among everyone who signed up; if not, it's refunded to them. ## Your entries The Mine page in Oh My Luck lists the activities you've joined and how they turned out (waiting to draw, won, settling, and so on). ## Related pages - [Tipping posts and members](/en/member-guide/tipping) - [Your account: profile, Spark & leaving a circle](/en/member-guide/your-account) --- #### Story subscriptions > Follow the sources you like, shape your own feed, and control push notifications. > > Source: https://docs.ohmy.xin/en/member-guide/story-subscriptions/ Circles on the Story Hub layout subscribe to outside sources (X (Twitter), YouTube, Telegram, Discord, and more) and bring the good stuff into the circle as stories. You follow just the parts you enjoy. ## Following sources 1. Open the circle's **sources** page and browse what's available to follow. 2. Tap **Follow** — that source's stories start flowing into your personal timeline. 3. On the stories page you can switch views: followed only, circle discussion, or everything. When you first join, the owner may have prepared a starter pack: the bot sends curated story source cards — tap **Follow** on a card to subscribe in one step, or ignore the ones you don't care about. ## Controlling push - Every source you follow has its own **push notifications** switch, on by default. - The notification preferences page manages push for all your followed sources in one place. - When a new story is published, the bot sends you a card where you can **read** and **comment**; with push off it just sits quietly in your timeline. - If you're on a trial, story cards come with a note of how many trial days you have left. ## Try it here The lab below walks the whole chain: follow a source or two from the starter-pack cards, flip push on and off, unfollow, then publish a story and watch when the bot sends a card you can read and comment on — and when it stays quiet. ## If something goes wrong - **Your timeline is still empty after following** — stories only appear once they're published. Switch to everything first to see what the circle already has. - **You want to keep following but stop the push** — just turn off that source's push switch; the follow itself is untouched. ## Related pages - [Circle home pages: the four layouts](/en/member-guide/layouts) - [Your account: profile, Spark & leaving a circle](/en/member-guide/your-account) --- #### Tipping posts and members > Tip a post or a member — they receive the full amount straight in their Mixin wallet. > > Source: https://docs.ohmy.xin/en/member-guide/tipping/ When you like something, you can back it with your assets right away. The platform forwards your tip immediately: the recipient gets the full amount straight in their Mixin wallet — no platform cut, nothing held back. ## How to tip 1. Tap **Reward** under a post, or open a member's avatar / profile page and tap the **Reward** button there. 2. Pick an amount and an asset in the dialog (the coins this circle accepts). 3. Tap **Pay with Mixin Messenger** and confirm the transfer. 4. It lands within seconds, and they receive the full amount — the platform takes no cut. ## After you tip - You'll see a "Reward sent" confirmation. - The people who tipped show up as a list of avatars under the post and on the member's profile page. - After the tip goes through, you can verify the transfer with its Trace in your Mixin Messenger transaction history. ## If something goes wrong - **Told that the circle has no tipping tokens set up** — the circle owner hasn't picked which assets to receive yet. Just let an admin know. - **They say nothing arrived after you paid** — look up the transfer with its Trace; it usually lands within seconds. ## Related pages - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [Red packets, lotteries & quizzes](/en/member-guide/luck) --- #### Watching lives and replays > Where to find circle lives, how to enter the room, playback lines, and replays. > > Source: https://docs.ohmy.xin/en/member-guide/live/ When a circle goes live, you can enter the room from the circle home, the live card in chat, or the Oh My Live directory. ## Finding a live - **Circle home** — the live strip shows the viewer count while on air and the start time for the next live. - **Circle chat** — the bot sends a live card when the stream starts; tap it to enter the room. - **Oh My Live** — the `/live` directory gathers on-air lives, upcoming lives, and replays from your circles. Lives from other circles are listed too, but watching still requires joining that circle. For a scheduled live, tap **Remind me**; the bot messages you before it starts. ## Inside the room - Tap play on the stage to start watching; the top shows the host, viewer count, and time on air. - The playback line is picked for your network automatically. When it cannot tell, it asks you to choose **Outside mainland China** (ultra-low latency, about 1 s, with automatic fallback) or **Mainland China network** (standard playback, the most stable choice). Your choice is remembered and can be switched from the top of the room at any time. - Room chat mirrors circle chat and follows the circle's [chat mode](/en/member-guide/chatting). When you cannot post, the composer explains why. - When a live ends or is cancelled, the stage shows its state; if a replay exists, you can open it from there. ## Try the room The demo below recreates the real room. Tap **Tap to watch** — when your network cannot be detected, the room asks you to pick a line. Then use the console to switch the network or the chat mode and watch the room, the composer, and its hints react. ## Replays - Live replays live in the circle's replay list and in the Oh My Live replays rail. - The replay page reuses the room chrome, and you can jump between recording segments. ## If something goes wrong - **The live will not open** — it may not have started, may have ended, or may have been cancelled; refresh to see the current state. - **Playback stutters** — switch the playback line from the top of the room; on a mainland-China network, choose Mainland China network. - **You cannot post** — the current chat mode does not allow it; the composer explains why. Try again once Q&A opens or the mode changes. - **You cannot see a circle's live** — join that circle first; Members-only lives never appear in the public directory. ## Related pages - [Chatting in a circle](/en/member-guide/chatting) - [Circle home pages: the four layouts](/en/member-guide/layouts) - [Buying & renewing membership](/en/member-guide/membership) --- #### Your account: profile, Spark & leaving a circle > A tour of the Mine page — membership status, notification preferences, Spark points, and leaving a circle. > > Source: https://docs.ohmy.xin/en/member-guide/your-account/ A circle's **Mine** page is your personal hub inside that circle: membership status, orders, notification preferences, invites, and settings all live here. ## Your identity is your Mixin account OhMy.xin needs no separate profile setup: your avatar and name come straight from your Mixin account. What you manage are your preferences in each circle, not a new profile. ## Notification preferences Toggle each item on the notification preferences page: new posts, posts by the circle owner, new comments, likes, reward broadcasts, red packet grabs, new members joining, and whether you get circle messages at all. Switched off, they never bother you; switched on, you know the moment they happen. ## Spark Spark is a points system that rewards showing up regularly: - **How you earn** — reading posts, reacting, commenting, posting, and chatting all score, up to a daily cap; your first qualifying action each day keeps your streak alive. - **Levels** — points you bank light up five levels: Ember, Kindling, Flame, Blaze, Beacon. - **Just for you** — there's no public leaderboard, and points can't be spent, transferred, or cashed out. Some activity red packets unlock by Spark level. ### Try lighting a day The lab below recreates the points and the streak: tap any action to see how the day's first move lights the streak and how the bonus grows with the days (capped at +7); then use "Next day" to extend it and "Skip two days" to see the reset rule — the current streak zeroes, but the longest streak, lifetime spark, and your level never go back down. ## If you're away for a while If the circle owner has set an inactivity period, you'll get a reminder first (up to three) when you haven't opened Mixin for a long time; after that circle messages pause. **Open Mixin again and everything resumes on its own** — no need to contact anyone. ## Leaving a circle Tap **Leave** at the bottom of the **Mine** page and confirm: you stop receiving everything from the circle and can no longer reach its content. Free circles you can rejoin any time; paid circles need an active membership again. ## Related pages - [Buying & renewing membership](/en/member-guide/membership) - [Red packets, lotteries & quizzes](/en/member-guide/luck) ### Creator guide / 创作者指南 #### Before you begin: costs & prep > What creating a circle costs and what to have on hand — the numbers, up front. > > Source: https://docs.ohmy.xin/en/creator-guide/before-you-begin/ Creating and running a circle is **free**. The only costs you'll ever run into fall into two buckets, and both are out in the open. ## How the platform charges - **Membership and member tier orders: 10% platform service fee** — for every membership or tier payment a member makes, the platform takes 10% and the rest is yours. If the inviter bonus is on, the inviter gets a share of each order at the rate you set. - **Lucky activities like red packets and lotteries: 0% platform service fee** — every bit of the activity funds goes to the participants. - **Circle VIP: optional** — premium features such as extra layouts and video posts are prepaid monthly (1/3/12-month plans); see [Pricing & fees at a glance](/en/reference/pricing-and-fees) for prices. ## How your money reaches you For every membership or tier payment, the platform immediately forwards your net income (order amount − 10% service fee − any inviter bonus) straight to your own Mixin wallet as a Mixin Safe transfer — usually within seconds to a few minutes, nothing to withdraw. See [Owner income and payouts](/en/mixin-basics/owner-payouts). ## What to have ready - A Mixin account. - About 30 minutes: create a bot, connect it, and set up the basics. - A safe place to keep your bot's credentials file (keystore) — you'll upload it when connecting. - A clear idea of your circle: who it's for, whether to charge, and at what price (all adjustable later). ## Related pages - [Create a bot on Mixin](/en/creator-guide/create-your-bot) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) - [New here? Pick your path](/en/start-here/pick-your-path) --- #### Chat modes & auto-replies > Pick the right message mode and set up auto-replies and filters to keep the conversation under control. > > Source: https://docs.ohmy.xin/en/creator-guide/chat-modes-for-owners/ **The chat mode decides who hears whom.** Choose a mode, then send a few messages and watch whose phone each one reaches. > **Which mode should I pick?** > - Private one-on-one Q&A → **Default** > - You post, everyone reads → **Broadcast** > - A live class that becomes a replay → **Lecture** > - Everyone chats together → **Group** **VIP** > ## Who sees what | Mode | You send a message | You quote-reply a member | A member sends a message | | --- | --- | --- | --- | | Default | Not sent — the bot reminds you to quote | That member only | You and your admin team | | Broadcast | Everyone | That member only | You and your admin team | | Lecture | Everyone, recorded for the replay | That member only | You and your admin team, only while Q&A is open | | Group | Everyone | Everyone | Everyone | "You" covers your admins and lecturers too — they post with the same reach as the owner. In an **Oh My Live room**, chat follows the same mode: members see the same reach as in circle chat, and the composer explains why when they cannot post. The owner and admins can switch the mode right in the room, and every open room reloads its chat to follow. ## Switching modes - Go to **Console → Settings → Chat rules**, or send `/help` to your bot for a quick switch. - Members who subscribed to messages get a direct message every time you switch. - **Lecture** asks you to confirm first, because recording starts right away. Q&A starts closed: send `/qa on` to take questions and `/qa off` to stop. A replay post is created when you finish. - **Broadcast** also collects the previous day's broadcasts into a replay automatically. - **Group** requires [Circle VIP](/en/reference/pricing-and-fees). If VIP lapses, the circle falls back to Broadcast. ## Auto-replies **Console → Chat → Auto-replies**: pick a trigger keyword and what the bot sends back — text, a long-form post, a contact card, or an app card with cover, title, and buttons. - A new member sends "start" → the bot replies with your guide post. - Someone sends "courses" → the bot replies with a card linking to the purchase page. - Triggers exact-match the member message (one rule can carry several, comma-separated); when one trigger has several rules, **the first created wins**. - App-card buttons come as **link** or **send text** — send-text posts that text as the member, which can hit your own trigger and chain another layer: see [Playbook: bot onboarding](/en/playbooks/bot-onboarding). - Test-run any rule on the page, or send it to your own Mixin to preview. > **caution** > A trigger keyword that matches a platform command (like `/help`) replaces that command in your circle. The console warns you when this happens. > ## Managing replays Replays from Lecture and Broadcast modes gather in **Console → Chat → Replays**. A fresh replay is **visible to you only**: give it a proper title here (the default is generated from the date), flip it to member-visible once it's ready, and it appears in the replays list on the circle site. The list shows each replay's message count and average receipts so you can see which sessions landed; hide it again any time. ## Message filtering and pacing In **Settings → Chat rules**: - **Message cooldown** — the minimum seconds between two messages from the same member (120 = one message every two minutes; 0 turns it off). - **Content filters** — block links, images, voice, or card messages automatically. ## Related pages - [Content moderation](/en/creator-guide/moderation) - [Live video streams (Oh My Live)](/en/creator-guide/live-streams) - [Playbook: bot onboarding](/en/playbooks/bot-onboarding) - [Welcome experience](/en/creator-guide/welcome-experience) --- #### Choose your layout > Classic, Story Hub, Community Hub, Trading Hub — pick the right face for your circle, and know what you can customize. > > Source: https://docs.ohmy.xin/en/creator-guide/choosing-your-layout/ The layout decides what members see when they open your circle. Find it in Console → Settings → Appearance. Only the circle owner and admins can change it; for other members of the team the Appearance section is read-only. ## The four layouts Classic is the default. Story Hub and Trading Hub are [Circle VIP](/en/reference/pricing-and-fees) layouts: without VIP their cards carry a badge and stay unselectable, with the upgrade link right on the card. ## The layout rail and switching The Appearance section is a horizontal layout rail: one preview card per layout, the current layout pinned first. Pick another layout and hit "Save layout" — the console shows a confirmation dialog with an **impact summary** of which features become available and which stop being available, and only switches after you confirm. Switching deletes nothing: posts, members, and orders all carry over, and **layout customization is stored in the circle's layout settings** — switch back later and everything is as you left it. What changes is availability: channels are Classic-only, strategy management and live courses are Trading Hub-only, the starter pack is Story Hub-only, and home entries exist in Story Hub / Community Hub / Trading Hub. Every switch and every customization is recorded in the change history. ## Layout customize: what each layout can change Each layout card's "Layout customize" button opens a side sheet. Classic and Community Hub have nothing to customize — the console says so — while the two VIP layouts each get their own sheet: - **Story Hub**: navigation labels, what you call sources / stories, and the home title / subtitle / banner, plus a Home entries tab — see [Customize Story Hub](/en/creator-guide/customize-story-hub). - **Trading Hub**: the home channels (order, on/off, short names) and the bottom nav slots, plus home entries, showcase pages, and cards managed right in the sheet — see [Customize Trading Hub](/en/creator-guide/customize-trading-hub), [Home entries](/en/creator-guide/home-entries), and [Showcase pages & cards](/en/creator-guide/showcase-pages-cards). While a layout switch is pending, the customize button stays disabled until you save or discard the switch; closing the sheet with unsaved edits asks first. Outside the sheet, the Appearance section keeps the layout-independent switches: shareable post cards, post tags (up to 20), and the trading entry and types (Trading Hub) — see the [settings reference](/en/creator-guide/settings-reference). The app card cover used when a post is shared to Mixin (≤5 MB) lives in [Welcome experience](/en/creator-guide/welcome-experience). ## Related pages - [Customize Story Hub](/en/creator-guide/customize-story-hub) - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Home entries](/en/creator-guide/home-entries) - [Content toolkit](/en/creator-guide/content-toolkit) --- #### Circle VIP > What VIP unlocks, what it costs, how to renew, and what happens at expiry. > > Source: https://docs.ohmy.xin/en/creator-guide/circle-vip/ Circle VIP is an optional premium feature subscription, billed per circle. Find it at Console → **Money** → **Upgrade VIP**. > **Not the same as a member tier** > Circle VIP is the feature subscription you buy from the platform (layouts, story feeds, Group mode); a member tier is the Pro content layer you sell to members (Console → Money → Member tiers). They are set up and billed separately — see [Membership & pricing](/en/creator-guide/membership-and-pricing). > [Screenshot: The console Upgrade VIP page for an active circle] ## What it unlocks - The **Story Hub** and **Trading Hub** [layouts](/en/creator-guide/choosing-your-layout) - **Group mode** — one big group where everyone talks to everyone - **Custom accepted assets** — receive payments beyond the default currency (Money → Currency) - **Story feeds** — external content subscriptions (see [Story feeds](/en/creator-guide/story-feeds-and-sources)) - **Participant filters** for raffles and red packets — filter who can take part by custom conditions - **Video posts** — posts with a short video attached, cover generated automatically - **Live video streams** — members-only lives with in-chat cards, a low-latency room, and replays (available once the platform enables it for your circle; see [Live video streams](/en/creator-guide/live-streams)) ## Pricing & payment | Cycle | Price | | --- | --- | | Monthly | $9.99 | | Quarterly | $29.99 | | Yearly | $99.99 | Pay with BTC, PUSD, USDT or XIN; orders are valid for 15 minutes. [Pricing & fees](/en/reference/pricing-and-fees) is the authoritative source for the numbers. ## Renewal & expiry - **Renewals extend from the current expiry date** — you lose none of the remaining days; payment takes effect immediately. - 7 days before expiry, a **VIP expiring soon** reminder appears on the **Today** page, where you can start a renewal order directly. - **Expiry does not tear anything down**: enabled layouts and content keep running as usual; you just cannot switch to a VIP layout, turn on Group mode, or use features like source management any more. - Renewing also lifts [dormancy](/en/creator-guide/lifecycle). ## Related pages - [Choosing your layout](/en/creator-guide/choosing-your-layout) - [Lifecycle: dormancy, reconnect & transfer](/en/creator-guide/lifecycle) --- #### Connect to OhMy.xin > Drop in keystore.json, paste the Client Secret, click Launch Bot — OhMy.xin configures the rest. > > Source: https://docs.ohmy.xin/en/creator-guide/connect-to-ohmyxin/ Got `keystore.json` and the Client Secret? Then this part takes about two minutes. Haven't got them yet — start with [Create a bot on Mixin](/en/creator-guide/create-your-bot). ## Steps The walkthrough below starts at the OhMy.xin half. Click any earlier step to see where each item came from. > **You don't need to touch Mixin settings again** > The Home URL and OAuth URL you typed on Mixin were placeholders. During auto-configure, OhMy.xin writes the real Home URL, OAuth callback and resource patterns to your bot for you. > [Screenshot: The real wizard, step 2.] ## One bot, one circle If the bot has been connected to another circle before, that circle has to disconnect it first before you can connect it to a new one. Disconnecting doesn't touch the bot on the Mixin side — reconnecting brings everything back. ## If something goes wrong
"Invalid JSON — please paste the complete keystore.json content" Only part of the file got pasted, or something else (often the Client Secret) went into the keystore box. Easiest fix: click **Choose file** and pick `keystore.json` instead of pasting. If you paste, copy everything from the first `{` to the last `}`.
"Missing fields: app_id, session_private_key, …" The file is from an older-style session that uses different field names. On developers.mixin.one, open **Secret → App Session → Generate a new key** and use the new file.
Launch Bot fails with a credentials error The keystore and the secret don't belong together, or one of them was regenerated afterwards. Check they're from the same bot, and use the **newest** secret and the **newest** keystore file.
"Auto-configuration needs a retry" Your bot is saved — only the Mixin profile update didn't finish, usually because Mixin was briefly unreachable. Click **Retry auto-configuration**. There's nothing to change on developers.mixin.one, and retrying is safe.
## Related pages - [Create a bot on Mixin](/en/creator-guide/create-your-bot) - [Launch checklist](/en/creator-guide/launch-checklist) - [Bots: how circles work](/en/mixin-basics/bots) --- #### Content moderation > The Review queue, anti-harassment rules, blocking, and recalls — every tool for keeping your circle clean. > > Source: https://docs.ohmy.xin/en/creator-guide/moderation/ The day-to-day entrance to moderation is Console → **Review**: everything that needs your judgment gathers here — held spam, flood alerts, stories waiting to publish, and story sources that failed to fetch. [Screenshot: The console Review queue with held spam and a flood alert] ## Spam protection rules Settings → Spam protection: - **Enable spam protection** — suspicious messages are held back instead of delivered to members, and land in the Review queue for you to decide. - **Strictness** — Relaxed / Balanced / Strict, setting how aggressively things get intercepted. - **Link policy** — allow links, block links, or only allow domains on the allowlist. - **New-member scrutiny** — a new member's first N messages get extra checking (0 = the platform default of 5). - **Custom keywords** — block words and allow words (allow words can override false positives), with whole-message, phrase, and anywhere matching. [Screenshot: The Spam protection section of console Settings] Held messages have four actions: **Approve** (a false positive), **Confirm Spam**, **Confirm & Block**, and **Dismiss**. Approve and Dismiss can be undone within 10 seconds; Confirm Spam and Confirm & Block are final. ## Try it here The lab below brings the rules to your fingertips: on the left change the settings (strictness, link policy, block/allow words, who is sending), type a message or tap a preset, and the right side shows instantly whether it reaches members or lands in Review — and why. Held messages offer the four actions: Approve and Dismiss carry an undo; Confirm and Block are final. ## Flood alerts The platform spots abnormal flooding and repeated sending on its own, even if you configure no rules. Confirming an alert blocks the member and bulk-recalls their messages from within the window; a false positive can simply be dismissed. The "join spikes" probe on the Members page helps you spot unusual bursts of joins. ## Blocking, recalling, and anonymous verification - **Block a member** — do it from the Members page, or quote a message and send `/block`. Blocking also bulk-recalls their messages from within the recall window (30 days). - **Recall a message** — quote it and send `/recall`, or recall messages one by one in Console → Chat → Messages; limited to the last 30 days. - **Anonymous verification** — in anonymous mode, regular members speak anonymously, but the circle owner and admins can quote a message and send `/reveal`; the bot direct-messages you the member's real identity without making it public. ## History Every moderation and management action (mode switches, blocks, rule changes, and so on) is written to Settings → History automatically. Reversible actions can be rolled back with one click; sensitive ones like blocks also direct-message the circle owner. ## Related pages - [Chat modes & auto-replies](/en/creator-guide/chat-modes-for-owners) - [Members & roles](/en/creator-guide/members-and-roles) --- #### Content toolkit > Posts, articles, channels, friendly links, share apps, and the content unique to each layout. > > Source: https://docs.ohmy.xin/en/creator-guide/content-toolkit/ Console → **Content** gathers everything you can publish and arrange. Create the content first, then decide where it surfaces. ## Posts and articles - **Posts** — support images or a single video (video up to 200 MB, requires Circle VIP), plus polls, lotteries, and question posts. Posts can be pinned (one per channel), moved between channels, and pushed as notifications. Whether members can post is decided by "Who can post". - **Articles** — long-form content, pushed to subscribed members when published. Visibility levels: public / trial / members only. - **Article collections** — articles organized in order into a learning path or a theme, with the same visibility levels. - **Audience** — if the circle has a [member tier](/en/creator-guide/membership-and-pricing), posts, articles, strategies, and public answers can point at a tier; anything left at the default stays visible to everyone. ## Channels Channels sort posts by topic. Everyone starts in the "General" channel; the rest are yours to create. Once members subscribe, their timeline filters by channel. Keep it to 5 or fewer, and only members you authorize can post in a given channel. ## Video lives (Oh My Live) VIP circles can host video lives for members: Console → Content → Lives. - Start a live: add a title and cover, then go now or schedule a start time; pick the audience — **Members only** or **Listed on Oh My Live**. - When you go live, members get a live card in circle chat and the circle home shows a live entry; scheduled lives can be reminded in advance. - Recordings become replays. The console's Lives page groups on air, upcoming, and past sessions and shows this month's used live minutes. Lives must be enabled for your circle by the platform; until then the console shows no Lives entry. See [Live video streams (Oh My Live)](/en/creator-guide/live-streams) for the full setup. ## Friendly links Put other Mixin bots (including circles hosted on the platform) on the services page as cards, with a description and tags (up to 5 tags, ≤20 characters each). The same data drives the "Recommended bots" page in Story Hub and the bot filter tags in Trading Hub. ### Try it here Edit one friendly link below and watch the same data surface on three pages: the services-page card, Story Hub recommended bots, and the Trading Hub filter tags. Tags are comma-separated, capped at 5 with 20 characters each — going over is rejected, not silently trimmed; and hiding the link removes it from all three at once. ## Share apps Console → Content → Share apps: pin other Mixin bots onto your bot's name card, where members see them the moment they open the profile and can jump straight in. Add a bot by its Mixin ID and remove it any time. A good spot to cross-promote your other circles or a partner's bot. ## Layout-specific content - **Story Hub** — external story sources (X, YouTube, Telegram, Discord; requires [Circle VIP](/en/reference/pricing-and-fees)): each source can auto-publish, has its own push toggle and icon; set up a starter pack of up to three sources for new members. - **Trading Hub** — strategies (entry / target / stop-loss levels and status), live courses (go-live reminders), [showcase pages & cards](/en/creator-guide/showcase-pages-cards) (win rate and trade sessions), and locked posts unlocked by an inviter code (eligibility is set by [Mixin Rewards](/en/creator-guide/insights-and-growth)). Strategies aren't console-only: the owner and admins can create and maintain them right from the member site — see [the four layouts](/en/member-guide/layouts). ## Related pages - [Choose your layout](/en/creator-guide/choosing-your-layout) - [Money: orders & payouts](/en/creator-guide/money-orders-payouts) --- #### Create a bot on Mixin > Register a free bot on developers.mixin.one and collect the two things OhMy.xin needs — keystore.json and the Client Secret. > > Source: https://docs.ohmy.xin/en/creator-guide/create-your-bot/ Every circle runs on its own Mixin bot. You register it yourself, for free, on Mixin's developer site — and walk away with **two things**: a file called `keystore.json` and a line of text called the **Client Secret**. > **The 30-second version** > On [developers.mixin.one](https://developers.mixin.one/dashboard): **New App** → **Save** → **Secret** tab → **App Session: Generate a new key** (Download `keystore-7000101234.json`, named after your bot's Mixin ID) → **OAuth Client Secret: Generate a new secret** (Copy it). Then hand both to OhMy.xin. Do it on a computer — you'll be moving a file around. > ## Try it here first Click through the whole thing below — the left half happens on Mixin, the right half on OhMy.xin. Watch the tray under the browser: it fills up as you collect each item. ## The two things, side by side > **Treat keystore.json like your wallet** > Whoever holds it can send messages as your bot and spend from its wallet. Upload it **only** to the OhMy.xin wizard, and never send it to anyone — including people claiming to be official support. If it ever leaks, click **Generate a new key** under App Session: the old file stops working. > ## If something goes wrong
The QR code won't sign me in Scan it from inside Mixin Messenger (the scan button in the top corner), not with your camera app, and make sure Messenger is up to date.
Save is greyed out or rejected Check that every field is filled. Mixin has required a description of at least 16 characters, and both URLs must start with `https://`. Any https address is fine — OhMy.xin rewrites them later.
I closed the window before downloading or copying Mixin doesn't store either one, so it can't show them again. Generate a new one — **Generate a new key** for the keystore, **Generate a new secret** for the Client Secret — and use the newest in OhMy.xin.
I can't find the downloaded file Look in your browser's downloads list (Ctrl+J / ⌘⇧J). Look for `keystore-` followed by your bot's Mixin ID, like `keystore-7000101234.json`. A second download may get a number added, like `keystore-7000101234 (1).json` — that's fine. If you clicked the button twice, use the newest file. Or skip the file: click **Copy** in the App Session window and paste the text into OhMy.xin.
## Related pages - [Connect to OhMy.xin](/en/creator-guide/connect-to-ohmyxin) - [Your Mixin account & Mixin ID](/en/mixin-basics/your-mixin-account) - [Staying safe on Mixin](/en/mixin-basics/staying-safe) --- #### Creator guide > From creating a circle to running it day to day — the complete console handbook. > > Source: https://docs.ohmy.xin/en/creator-guide/ Everything circle owners and operators need: creation, pricing, moderation, content, money, and growth. [Screenshot: The console opens on Today.] ## In this section - [Before you begin: costs & prep](/en/creator-guide/before-you-begin) - [Create your bot on Mixin](/en/creator-guide/create-your-bot) - [Connect it to OhMy.xin](/en/creator-guide/connect-to-ohmyxin) - [The launch checklist](/en/creator-guide/launch-checklist) - [Membership & pricing](/en/creator-guide/membership-and-pricing) - [Choosing your layout](/en/creator-guide/choosing-your-layout) - [Customize Story Hub](/en/creator-guide/customize-story-hub) - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Home entries](/en/creator-guide/home-entries) - [Showcase pages and cards](/en/creator-guide/showcase-pages-cards) - [The welcome experience](/en/creator-guide/welcome-experience) - [Chat modes and auto-replies](/en/creator-guide/chat-modes-for-owners) - [Message templates and broadcasts](/en/creator-guide/message-templates-and-broadcasts) - [Moderation](/en/creator-guide/moderation) - [The content toolkit](/en/creator-guide/content-toolkit) - [Live video streams (Oh My Live)](/en/creator-guide/live-streams) - [Story feeds and sources](/en/creator-guide/story-feeds-and-sources) - [Money: orders and payouts](/en/creator-guide/money-orders-payouts) - [Luck campaigns: red packets, lotteries, and quizzes](/en/creator-guide/luck-campaigns) - [Spark points](/en/creator-guide/spark-points) - [Members and roles](/en/creator-guide/members-and-roles) - [Insights and growth](/en/creator-guide/insights-and-growth) - [Settings reference](/en/creator-guide/settings-reference) - [Circle VIP](/en/creator-guide/circle-vip) - [Lifecycle: dormancy, reconnection, and transfer](/en/creator-guide/lifecycle) No circle yet? Start with [Create your own circle](/en/start-here/create-a-circle). --- #### Customize Story Hub > Tab labels, the source/story vocabulary, the home title and banner — every option in the customize sheet, with an interactive demo. > > Source: https://docs.ohmy.xin/en/creator-guide/customize-story-hub/ Story Hub is one of the two layouts with a customize sheet. Open **Console → Settings → Appearance**, click "Customize" on the Story Hub layout card, and the sheet has two tabs: "Layout" holds every appearance option, and "Home entries" manages the member home's quick cards (see [below](#the-home-entries-tab)). Only the owner and admins may change them. The console on the left simulates the sheet; the phone on the right follows every rule live: - The **navigation labels** drive the tab bar *and* each page's title; when the Sources/Stories labels are empty, their defaults follow the vocabulary nouns. - A **vocabulary** rename flows into every piece of member copy that mentions sources or stories — intros, follow counts, home entries. - An empty **home title** falls back to the circle name; an empty **subtitle** line is not rendered at all. - The **banner** renders as a full-bleed background with a dark gradient so the text stays readable. ## Experiments to try 1. Rename the "Sources tab" to "Radios", then clear it — once empty it follows the "Source name" default. 2. Change "Source name" to "Wire": the tab bar, the sources intro, and the home entry tile all follow. 3. Leave the home title empty (it starts that way): the nameplate falls back to the circle name "Daily Notes". 4. Tick the sample banner: the hero becomes a full-bleed banner with a dark gradient. 5. Switch to the "Home entries" tab and untick "💼 Membership": the card leaves the home directory; tick it again to restore — a disabled entry stays in the management list. ## Every option in the sheet ### Navigation labels | Field | Default | Limit | Where it shows | | --- | --- | --- | --- | | Home tab | Home | 40 chars | 1st tab; home page title | | Sources tab | Sources | 40 chars | 2nd tab; sources page title | | Stories tab | Stories | 40 chars | 3rd tab; stories page title | | Mine tab | Mine | 40 chars | 4th tab; profile page title | ### Vocabulary | Field | Default | Limit | Notes | | --- | --- | --- | --- | | Source name | Source | 40 chars | Replaces "source" across member copy | | Source plural | Sources | 40 chars | Hidden for zh circles; auto-follows the singular | | Story name | Story | 40 chars | Replaces "story" across member copy | | Story plural | Stories | 40 chars | Hidden for zh circles; auto-follows the singular | The vocabulary seeps into member copy — intros, follow buttons, empty states. Renaming changes no data: existing sources and follows are untouched; only the wording changes. ### Home copy | Field | Default | Limit | Where it shows | | --- | --- | --- | --- | | Home title | none | 120 chars | The big nameplate; empty falls back to the circle name | | Home subtitle | none | 120 chars | Line under the title; empty is not rendered | | Home banner | none | JPEG / PNG / WebP / GIF, ≤5 MB, wide ~3:1 | Full-bleed hero background; a "remove current banner" checkbox appears after saving | | Sources directory intro | none | 2000 chars | Saved in the sheet; not yet shown on the member site in the current version | :::note[Home announcements are not here] The sheet carries a hint card: use the **notice bar** for home announcements, or pin a post — they are not part of layout customization. ::: ## The Home entries tab The sheet's Home entries tab manages the quick cards on the member home: each has a title (≤80 chars), an optional description (≤500), an icon, and an order — tap one and it lands on a circle page or an external site. The list, new-entry button, editing, and deletion all happen inside the sheet, mirroring the showcase pages / cards tabs. - Jump targets cover **circle content** (articles, collections, the sources directory, one source, the guide), **member self-service** (orders, membership, questions, red packets…), and **bots / links** — a dozen-plus kinds; the full catalog is on [Home entries](/en/creator-guide/home-entries). - **Folders** live at the top level only and group related entries. The typical Story Hub pattern: tuck the guide, a learning-path collection, and one curated source into a "Start here" folder, with a "Membership" entry beside it — the newcomer path and the conversion path sit right on the home page. - An unfilled jump target, Q&A / red packets being off, and a few other conditions hide an entry from members; the management list flags each reason inline (full rules on [Home entries](/en/creator-guide/home-entries)). The starter pack (up to three featured source cards sent to new members on join) is not in the sheet — it's configured in the [Content toolkit](/en/creator-guide/content-toolkit). ## Story Hub settings outside the sheet - Source category ordering and source tab groups (up to 4 groups, labels ≤20 chars) live on the [Story feeds & sources](/en/creator-guide/story-feeds-and-sources) page. ## Does switching layouts lose these settings? No. Customization is stored in the circle's layout settings, independent of the active layout: switch to Trading Hub and back, and the labels, vocabulary, and banner are exactly as you left them. ## Related pages - [Choosing your layout](/en/creator-guide/choosing-your-layout) - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Home entries](/en/creator-guide/home-entries) - [Story feeds & sources](/en/creator-guide/story-feeds-and-sources) --- #### Customize Trading Hub > Home channels, the bottom tab bar, and showcase pages — every option in the customize sheet, with an interactive demo. > > Source: https://docs.ohmy.xin/en/creator-guide/customize-trading-hub/ The Trading Hub customize sheet has four tabs: **Layout** (home channels and the bottom tab bar), **Home entries**, **Showcase pages**, and **Showcase cards**. The entry point is the same — Console → Settings → Appearance → Customize; only the owner and admins may change things. ## Home channels Three channel slots decide the channel nav at the top of the member home: - Each slot picks **News** (post feed), **Courses** (live calendar), or **Strategies** (signal panel) — or "— Disabled —". - **Slot order is display order**: put Strategies first and members land on the strategy panel. - Selecting the same channel twice is **ignored**; the first slot wins. - Each channel takes an optional **custom name** (≤20 chars) that replaces the default News / Courses / Strategies. - Saving validates: too many channels, unknown or duplicate channels, and over-long names are all rejected. Disabling a channel only hides it — posts, courses, and strategies stay; enabling it again restores the panel. ## Bottom navigation - **"Home" and "Mine" are fixed** anchors, not configurable. - Up to **three middle slots** each point at a showcase page; empty slots collapse away. - Each slot takes an optional **label** (≤20 chars) that overrides the page title on the tab — a page called "Strategy services" can simply read "Services". - If the circle has no showcase pages yet, the sheet prompts you to create one first. - Deleting a page later silently drops the slot that pointed at it. For the full slot semantics — how cards land on pages by tag and how pages reach members — see [Showcase pages & cards](/en/creator-guide/showcase-pages-cards), which has the complete interactive demo. ## The Showcase pages & cards tabs These two sheet tabs are shortcuts to showcase page/card management: create, edit, and delete inline without leaving the sheet. Persona win rates and session counts are maintained here too. ## The Home entries tab The quick-entry pill row above the channel nav on the member home is home entries. Each card has a title (≤80 chars), an optional description (≤500), an icon, and an order; the list, new-entry button, editing, and deletion all happen in this tab. - Trading Hub's signature move is the **showcase page** target: fill in the services page's numeric ID and members reach the strategy-services page in one tap from the pill row. - Add an **external link** (a market site) and an **article collection** (the starter course), and paid content is three taps away. - The dozen-plus other targets (articles, membership, bot entries, folders…) all work here too — the full catalog and hiding rules are on [Home entries](/en/creator-guide/home-entries). Try it in the demo above: switch to the "Home entries" tab, empty a slot to collapse its pill, override a label, and tap the "Strategy services" pill to jump straight to that page. The posts, courses, and strategies inside each channel are still managed on their own pages, not in the sheet. ## Signal import Once the platform opens a signal source for your circle, the source gets a settings block under **Strategies → Signal import** in the Trading Hub console: whether to import, whether imported signals are **saved as drafts** for review or **auto-published**, filtering to one plan or analyst, and who the strategies are attributed to (the owner by default). - Sources the platform has not opened do not appear; sources that do appear are off by default. - With drafts, a signal only shows in the console strategy list — members cannot see it and it does not enter the Story Hub until you publish it there. - With auto-publish, a signal becomes a public strategy as soon as it arrives, and members are notified. The platform only decides which circle may receive which source; the circle decides the rest. ## Does switching layouts lose these settings? No. Channel and tab-bar configuration is stored in the circle's layout settings — switch away and back, and everything is as you left it. ## Related pages - [Showcase pages & cards](/en/creator-guide/showcase-pages-cards) - [Home entries](/en/creator-guide/home-entries) - [Customize Story Hub](/en/creator-guide/customize-story-hub) - [Choosing your layout](/en/creator-guide/choosing-your-layout) --- #### Home entries > The full reference — every jump target, hiding rule, and management path. Home entries are part of layout customization, managed in the Story Hub and Trading Hub customize sheets. > > Source: https://docs.ohmy.xin/en/creator-guide/home-entries/ Home entries are quick cards on the member home page: a title (≤80 characters), an optional description (≤500), an icon, and an order — tap one and it lands on a circle page or an external site. Home entries are **part of layout customization**, available in **Story Hub, Community Hub, and Trading Hub**; Classic has none. ## Where to manage them - **Story Hub and Trading Hub**: the **Home entries** tab of the layout customize sheet (Console → Settings → Appearance → Customize). The list, the new-entry button, editing, and deletion all happen inside the sheet, mirroring the showcase pages / cards tabs — see [Customize Story Hub](/en/creator-guide/customize-story-hub) and [Customize Trading Hub](/en/creator-guide/customize-trading-hub). - **Community Hub**: no customize sheet — the management page is Console → Content → Home entries. ## The jump targets **Circle content** | Target | What members get | What to fill in | | --- | --- | --- | | Articles | The circle's article list | — | | One article | Opens that article | Article ID | | Article collection | The collection's ordered reading list | Collection ID | | Sources directory | The sources directory page | optional category slug filter | | One source | That source's page | Source ID | | Guide | The circle's onboarding guide | — | Numeric IDs are visible in the matching console list (or its page URL). **Member self-service** | Target | What members get | What to fill in | | --- | --- | --- | | Orders | The member's own order history | — | | Profile | The member's profile page | — | | Membership | Join / renew page | — | | Members | The member directory | — | | Questions | The questions page | — (hidden until Q&A is enabled) | | Red packets | The red-packet page | — (hidden until red packets are enabled) | **Bots & links** | Target | What members get | What to fill in | | --- | --- | --- | | Recommended bots | The friendly-links bot list | optional tag pre-filter (hidden with no visible links) | | Bot entry | Straight into another Mixin bot | pick one from friendly links | | External link | Opens an external site | full URL (https) | **Organization & display** | Target | What members get | What to fill in | | --- | --- | --- | | Folder | Expands a group of entries | top level only, no nesting | | Showcase page | Opens a showcase page (Trading Hub only) | the page's numeric ID | ### When an entry stays invisible An entry stays in the console list but hides from members when: the entry or its folder is **disabled**; the jump target is **not filled in yet** or **has been deleted**; Q&A or red packets are off; friendly links have nothing visible; the external URL is blank; or the folder holds no visible entries. The console list flags each reason inline. ### Try it here Walk the hiding rules above: the console list on the left flags each entry as members-see-it or hides-with-reason, and the member home on the right previews live. Disable an entry, clear the article ID or the external URL, switch Q&A or friendly links off — then flip to Community Hub to see folders group backstage and a single-target folder act as an alias. ### Use case: Community Hub · tool navigation Community Hub has no customize sheet, and the member home *is* the entry grid: top-level bot entries (price bot, support bot) and https links. In Community Hub, folders only group things backstage — members see top-level entries only, and a folder with a single target jumps straight there, which makes it a handy "alias". The Story Hub and Trading Hub patterns (the newcomer path, quick access) are embedded in [Customize Story Hub](/en/creator-guide/customize-story-hub) and [Customize Trading Hub](/en/creator-guide/customize-trading-hub) under their Home entries tab sections. ## Related pages - [Customize Story Hub](/en/creator-guide/customize-story-hub) - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Choosing your layout](/en/creator-guide/choosing-your-layout) - [Content toolkit](/en/creator-guide/content-toolkit) --- #### Insights & growth > The Statistics dashboard, the Today pulse, join spikes, and the invite-growth toolkit. > > Source: https://docs.ohmy.xin/en/creator-guide/insights-and-growth/ Console → **Insights** → **Statistics** is the circle's dashboard; the pulse on the **Today** page gives you the short-term trends that matter most. ## Statistics Time ranges of 7 / 30 / 90 days, across five dimensions: - **Members** — growth, churn and retention. - **Activity** — DAU, WAU, MAU. - **Content** — posts, articles, stories, comments and message volume. - **Revenue** — order income, red packet and tip flows (paid circles). - **Invites & growth** — invite conversion. [Screenshot: The console Statistics dashboard] The overview tiles cover total members, retention, average DAU, total revenue, average order value, red packet volume and invite conversion; there are also leaderboards for member activity / contribution / spending and a cohort retention table. Each block downloads as CSV on its own, or export everything in one click. ## Today pulse & join spikes The **Today** page shows members, DAU, new joins and revenue for the last 14 days, compared against the previous 7 days to give you the trend. When new joins reach 5 within 24 hours, a "Join spike" probe fires — go see which channel drove the growth. ## The growth toolbox - **Invite promotion** (Members → Invite promotion) — customize the invite copy (up to 500 characters) and the app card title (up to 36) and description (up to 1,024), so every share carries your selling points. - **Invite bonus** — set the inviter bonus rate in [Membership & pricing](/en/creator-guide/membership-and-pricing); to route "Rewards invitees" red packets to members brought in by chosen inviters, use Mixin Rewards below (the rebate is settled by Mixin out of the invitee's trading, separate from the platform's invite bonus). - **Get discovered** — Settings → Visibility: make the circle public and turn on preview browsing, and new visitors can browse your public content from the Explore page. - **Campaign acquisition** — the Newcomers audience on [Luck campaigns](/en/creator-guide/luck-campaigns) is built exactly for converting new members. ## Mixin Rewards **Members → Mixin Rewards**, which requires Mixin Rewards to be configured on the platform; without it the entry never appears in the Members menu. Mixin Rewards is Mixin's invitation-rebate program: once a member binds someone's invite code there, that inviter earns a rebate on the member's Mixin trading. This page decides whose invite codes count in your circle — the members you pick act as its **inviters**, and anyone they invited via Mixin Rewards (their invitees) earns two privileges. ### Claiming "Rewards invitees" red packets Only invitees can claim a "Rewards invitees" red packet from [luck campaigns](/en/creator-guide/luck-campaigns): - Invitees of any designated inviter can claim, and the packet creator's own invitees are always eligible. - **Empty is the default** — only the creator's invitees can claim. - **The list freezes when a packet is published** — the designated inviter list as of the moment the packet is funded is snapshotted into it, so later edits only affect packets published afterwards; a packet published with an empty list stays creator-only even after you add inviters. ### Unlocking invite-code-gated content Posts, strategies, and articles can be published with visibility set to "Unlock with inviter code" (Visibility: Public / Unlock with inviter code in the editor). Once gated: - The full text is visible only to invitees of the designated inviters; the circle's admins and lecturers always see it. - **With an empty list, gated content is staff-only** — designate inviters before using gated posts to recruit. - On the locked cover the member taps "Bind an inviter code" to bind an inviter's code on Mixin Rewards, then returns and taps "Already bound? Re-check" to unlock. - The **bind-code link** on the same page decides where "Bind an inviter code" leads: the official Mixin Rewards guide by default, overridable with an `https://` address or an in-site path. ### Maintaining the list - Search by name, Mixin ID, or Mixin UUID to add; blocked and follower roles cannot be added. - A member who left the circle is marked "No longer a circle member"; eligibility still follows the inviter UUID recorded by Mixin Rewards. ## Related pages - [Money: orders & payouts](/en/creator-guide/money-orders-payouts) - [Luck campaigns: red packets, raffles & quizzes](/en/creator-guide/luck-campaigns) --- #### Launch checklist > The four-step guide on the console's Today page, from finished connection to open for business. > > Source: https://docs.ohmy.xin/en/creator-guide/launch-checklist/ Once you're connected, the console's **Today** page lists four basic setup items and ticks each off as you complete it. Two of them only complete once the matching change is made: "Review entry and fees" ticks when charging is on, and "Choose public layout and appearance" ticks once you pick anything other than the default Classic layout. Check them all off and your circle is ready to run for real. ## The four items 1. **Set up welcome card and intro** — the first thing members see when they join: a welcome line, plus what your circle is about. 2. **Review entry and fees** — set your price and charging; this item only ticks once charging is on (see [Membership & pricing](/en/creator-guide/membership-and-pricing)). 3. **Choose public layout and appearance** — the layout of your circle's home page; this stays unticked while you keep the default Classic layout. 4. **Configure invite promo** — write the promo text shown on invite cards, so every share brings in new members. ## Try it here Fill in each item and watch it tick, the way it will in your console. The phone shows what members get. Anything you leave empty falls back to generic text, marked in yellow. ## In your console [Screenshot: The Getting started checklist on the console Today page] ## How it works The checklist stays on the **Today** page and ticks itself off as you finish each item. Day-to-day operations (reviews, content, stats) live in the left navigation and are unaffected by the checklist. ## After launch - Share your invite link in your group chats or on social media. - Watch the **Today** page for how things are going: content awaiting review, new members, and an earnings overview. - Build out your content over time: posts, articles, channels, and lucky activities. ## Related pages - [Membership & pricing](/en/creator-guide/membership-and-pricing) - [Connect to OhMy.xin](/en/creator-guide/connect-to-ohmyxin) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) --- #### Lifecycle: dormancy, reconnect & transfer > What happens when a circle goes quiet too long, how to reconnect credentials, and how to transfer ownership or delete the circle. > > Source: https://docs.ohmy.xin/en/creator-guide/lifecycle/ ## Dormancy & waking up After **30 days** of no activity, the admin team gets warnings first (starting 3 days before dormancy, up to three times); once the timer runs out, the bot goes offline and the circle enters dormancy: - Members opening a dormant circle are asked to contact the owner. - The owner or an admin sees a **Wake Up** button when opening the circle or its console; tapping it brings the bot back shortly after. - A dormant bot no longer receives messages; [renewing VIP](/en/creator-guide/circle-vip) lifts dormancy automatically, and circles with active VIP never go dormant. ## Disconnect & reconnect Settings → Bot connection (or the bot settings page): - **Disconnect** — pauses the connection to the Mixin Network and stops message delivery; you can reconnect any time. - **Reconnect** — restores the connection once validation passes. Note: **you can only reconnect the same Mixin bot** (client ID); to switch bots you have to delete the circle and start over (one bot maps to one circle). - **Rotate credentials** — requires disconnecting first; reconnecting asks you to type the circle number to confirm, guarding against accidents. ## Ownership transfer Settings → Danger zone → Transfer ownership (owner only): 1. Enter the target member's Mixin ID and tick the confirmation. 2. It takes effect immediately, no acceptance needed: they become the owner (revenue and payouts go to their wallet from then on), you become an admin, and your console access is unchanged. 3. Both parties receive a private message, and the action is written to the History. Admins cannot perform the transfer on the owner's behalf; double-check the recipient's Mixin ID. ## Deleting the circle Delete from the danger zone on the bot settings page: the bot must be disconnected first; deletion removes the circle's data and clears the stored bot credentials. Deletion is irreversible — to just pause, use disconnect or let the circle go dormant naturally. ## Related pages - [Circle VIP](/en/creator-guide/circle-vip) - [Settings reference](/en/creator-guide/settings-reference) --- #### Live video streams (Oh My Live) > Go live, pick an audience, push your stream, run the room, and manage replays — the complete Oh My Live guide. > > Source: https://docs.ohmy.xin/en/creator-guide/live-streams/ Oh My Live is [Circle VIP](/en/creator-guide/circle-vip) video streaming: the owner and admins push from OBS or a phone encoder, members watch in the circle or in the room, and the session can leave a replay. Find it at **Console → Content → Lives**. > **Check that it is enabled** > Lives must be enabled for your circle by the platform, and Circle VIP must be active. Until then the console shows no Lives entry; when VIP is unavailable, the lives page only shows the upgrade prompt. > ## Before you go live - **Who can host** — the circle owner and admins. - **Audience**: - **Members only** — only circle members can see and join it. - **Listed on Oh My Live** — the title and circle appear in the public `/live` directory; watching still requires joining the circle. - **Title, description, and cover** — the cover is 16:9, PNG/JPG, up to 5 MB. - **Start time** — go live now or schedule up to 30 days ahead. - **Recording** — record and publish a replay, and decide whether members can see it. - **Announcement** — a scheduled live can announce itself to subscribers; members can also set their own reminder. ## Push and go live 1. Create and save the live, then copy the **server** and stream key from Ingest. 2. Enter both in OBS or a phone encoder (Larix, Prism). 3. Recommended settings: H.264 + AAC, CBR single bitrate — 2500–4000 kbps for 720p30, 2-second keyframe interval, B-frames off, audio 128 kbps / 48 kHz. 4. **Go live** enables once your encoder starts pushing. If the push drops, the live enters a reconnect grace window and resumes automatically when the push returns. 5. **End** closes the live and members lose the stream. > **caution** > The stream key expires. Rotating it invalidates your current encoder settings, so enter the new key before your next session. > ## The lives desk Console → Content → Lives has three tabs: - **Now & upcoming** — the on-air sessions with recording state, elapsed time, and viewers, plus scheduled lives and reminder counts. - **Past** — each session's length, peak viewers, members who joined through the live, and replay state. - **Usage** — this month's live minutes and quota. You are warned at 90%, and a live ends automatically when the quota runs out. The platform can override the quota for an individual circle. A circle can only run one live at a time. ## The room and chat - Members enter from the live card in circle chat, the live strip on the circle home, or the `/live` directory. - Room chat mirrors circle chat and follows the current [chat mode](/en/creator-guide/chat-modes-for-owners): the mode decides what members see and whether they can post. - The owner and admins can switch the mode right in the room; every open room reloads its chat to follow. - Off air, the room hides the viewer count and composer. ### Try the room The demo below recreates the room from the **member's perspective**. Use the host panel on the right to switch modes and open Q&A — and notice two things: the member's chat hint reloads the moment you switch, and in Default mode even the host's own posts never reach the chat; switch to Broadcast or Lecture to speak to everyone. ## Replays - With recording on, the live produces a replay when it ends and adds it to the circle's replay list. - You control whether the replay is visible to members. The replay page reuses the room chrome and marks recording segments. ## If something goes wrong - **No Lives entry in the console** — the platform has not enabled it for the circle, or Circle VIP is not active. - **Go live is greyed out** — your encoder has not started pushing yet. - **The live ended on its own** — the monthly minutes may be used up, or the push was down past the grace window. - **Members cannot find the live** — check the audience; with Members only, only joined members can see it. ## Related pages - [Circle VIP](/en/creator-guide/circle-vip) - [Chat modes & auto-replies](/en/creator-guide/chat-modes-for-owners) - [Content toolkit](/en/creator-guide/content-toolkit) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) --- #### Luck campaigns: red packets, raffles & quizzes > Create marketing campaigns with Oh My Luck — funding, audiences, claim codes, and settlement, end to end. > > Source: https://docs.ohmy.xin/en/creator-guide/luck-campaigns/ Campaigns are the circle's engine for growth and activity: red packets, verifiable raffles, quizzes, and Twitter Follow tasks. Create them at Console → **Money** → **Campaigns** (you will be taken to the Oh My Luck creation page), or start directly from the Create page on the Oh My Luck web app. ## Creating a campaign - **Identity & visibility** — publish as yourself or as the circle; you can also choose to show it on the public Discover page at the same time. - **Four types** — red packet (amount and count, lucky-draw or even split, envelope style, greeting message, open time), verifiable raffle (prize pool, winner count, entry deadline and draw time), quiz (questions, all-correct share and top-rank share), Twitter Follow task (target account, target growth, deadline and prize pool). - **Audience** — everyone, Newcomers (first join within 24 h), [by Spark](/en/creator-guide/spark-points), or Rewards invitees (scoped by the [designated inviter list](/en/creator-guide/insights-and-growth) as it stands when the packet is published). - **Claim code protection** — a red packet can require a 4–16 character claim code that must be answered correctly to claim. - **Funding** — a single payment at creation covers the prize pool and the service fee (campaigns currently carry a 0% platform service fee); funds are held in the Oh My Luck wallet until claimed, and stay refundable until then. ## Settlement & refunds Try the rules below: send a red packet, run a lottery draw, or settle a quiz. Every number comes from the same arithmetic the app uses. - **Red packets** — end 24 hours after opening, with unclaimed amounts refunded automatically; **Newcomer red packets never expire** — they stay valid until you stop them manually (the balance is refunded). - **Verifiable raffles** — a scheduled job draws automatically at the draw time (public beacon); they cannot be settled manually. The whole prize pool is split evenly among the winners, so if fewer people enter than there are prizes, everyone who entered wins. If nobody enters, the raffle is cancelled and the pool refunded. - **Quizzes** — after the quiz ends, you (or a circle admin) tap **Settle quiz**. The perfect-score share is split evenly among everyone who got every answer right, the top-N share among the N best scores (an earlier submission wins a tie), and anything left over comes back to you. - **Twitter Follow tasks** — after the deadline you have 24 hours to upload screenshots confirming success or failure; if you do nothing in time, it auto-settles as success. On success the prize pool is split evenly among entrants; on failure it is refunded in full. Running campaigns cannot be cancelled; campaigns that have not started can be cancelled for a refund. ## Risk controls & permissions - **Newcomer claim protection** (Money → Campaign creator permissions): caps claims per IP over a rolling window (7 days by default) and auto-bans abusive IPs. - **Red packet amounts**: the pool only has to cover 0.00000001 per packet, so the real floor is what feels worth opening. - **Campaign creation permissions** (Money → campaign permissions page): turn on "can create" and "can publish publicly" per role. ## Related pages - [Red packets, raffles & quizzes (member view)](/en/member-guide/luck) - [Money: orders & payouts](/en/creator-guide/money-orders-payouts) --- #### Members & roles > The role ladder, seat caps, bulk actions, and exporting member data. > > Source: https://docs.ohmy.xin/en/creator-guide/members-and-roles/ Console → **Members** is the circle's people system: the member list, role management, membership gifts, and data export. ## The role ladder | Role | What it can do | | --- | --- | | Owner | Full powers: credentials, layout, transfer (one per circle) | | Admin | Day-to-day console work: Review, content, members, settings | | Lecturer | Speaks straight to everyone (Lecture / Broadcast), creates paid content, can post in channels the owner authorizes | | Member | Sees member content, chats, joins activities | | Follower | Follows for free, sees public content only | | Expired | The state after membership lapses; renewing restores it | | Blocked | Cannot access the circle | Admins and lecturers each have a cap of 10. ## Changing roles and renewing In the member list you can search (name / Mixin ID / UUID), filter by role, and sort by join date / recent activity / sparks. For a single member or in bulk: - **Set as admin / lecturer / member** — watch the seat cap when promoting into the admin team. - **Renew membership** — extend the membership directly; duration is selectable (up to 100 years, with "forever" as the usual way to say no expiry). - **Turn off disappearing messages** — bulk-remove the disappearing-messages limit on members' conversations with the circle. - **Block / unblock** — blocking also recalls their messages from within the recall window; see [Content moderation](/en/creator-guide/moderation). [Screenshot: The console Members page] ## Exporting member data The toolbar's **Export CSV** produces the full roster: member, Mixin ID and UUID, role, membership expiry, join date, last active, last IP, and inviter. Use it for an external CRM or reconciliation. ## Invite settings - The **inviter bonus rate** lives in Settings → Entry & pricing (see [Membership & pricing](/en/creator-guide/membership-and-pricing)). - **Mixin Rewards** (Members → Mixin Rewards) — decide whose invite codes count in the circle: inviters earn a rebate on their invitees' Mixin trading, and invitees can claim "Rewards invitees" red packets and unlock invite-code-gated content; see [Insights & growth](/en/creator-guide/insights-and-growth). - **Invite promo copy** — custom text on the invite card, configured in the launch checklist. ## Related pages - [Content moderation](/en/creator-guide/moderation) - [Money: orders & payouts](/en/creator-guide/money-orders-payouts) --- #### Membership & pricing > Pricing styles, billing periods, trials, and the inviter bonus — every option on the revenue side. > > Source: https://docs.ohmy.xin/en/creator-guide/membership-and-pricing/ The console's "Entry & pricing" settings decide how members pay. Every option can be changed at any time, and changes take effect right away. ## Two pricing styles - **Fixed price** — one price with one duration, for circles that want pricing kept simple. - **Subscription plans** — create several named plans (like Monthly and Yearly), each priced on its own, for members to choose from. A plan can carry an **intro price**: new members get a reduced price on their first order, then renewals return to the standard price. ## Member tiers: price a Pro content layer separately Beyond the entry fee, you can sell a Pro content layer: members join as usual, then buy a tier separately to unlock deeper content. - Where: Console → **Money** → **Member tiers**. Set the tier's name, description, price, currency, and duration. Duration is in months; leave it blank for a permanent tier, which is not offered for purchase in this phase. - A tier is a separate product: it does not change the entry fee, a member's role, or their membership expiry. Expiry only locks the tier content again. - Choose the **audience** when publishing: posts, articles, strategies, and public answers can point at a tier; anything left at the default stays visible to everyone. Members without the tier see a teaser and an unlock card. - Purchases use the same checkout as entry, and the platform fee and invite bonus apply the same way. **A member tier is not Circle VIP.** Circle VIP is the feature subscription you buy from the platform (layouts, story feeds, Group mode); a member tier is the content layer you sell to members. ## Billing periods & durations - **Yearly billing** — a fixed 12 months. - **Monthly billing** — you can open several duration options (like 1 month or 12 months) for members to pick from. ## Three dials for your revenue - **Trial days** — new members try the circle free for a set number of days before billing starts; set it to 0 for no trial. - **Renewal discount** — existing members renew at a reduced price, encouraging them to stick around. - **Inviter bonus rate** — when a new member pays after being invited, the inviter earns this percentage of the order (capped at 89%). Set it to 0 to turn it off. It's built-in word-of-mouth growth, at the cost of giving up part of your revenue. ## What members can pay with Pick which assets your circle accepts from the platform's supported list (USDT, PUSD, USDC, BTC, ETH, XIN, DOGE, EOS, BOX); members choose from them at payment time. ## How your earnings settle For every membership or member tier order: the platform takes a 10% service fee, the inviter bonus goes to the inviter at the rate you set, and the rest is yours — forwarded by the platform straight to your Mixin wallet for each order, usually within seconds to a few minutes, nothing to withdraw. The full numbers are in [Pricing & fees at a glance](/en/reference/pricing-and-fees). ## Related pages - [Launch checklist](/en/creator-guide/launch-checklist) - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) --- #### Message templates & broadcasts > Create reusable messages and send them to circle members or selected roles. > > Source: https://docs.ohmy.xin/en/creator-guide/message-templates-and-broadcasts/ Save frequently used content as a message template for welcome cards, introduction cards, auto-replies, or broadcasts. Circle owners and admins can send broadcasts from the console for reminders and announcements. ## Create a message template 1. Open **Console → Chat → Message templates** and choose **New template**. 2. Name the template and choose a message type: text, a long-form post, a contact card, or an app card. 3. Edit the content and check the preview. App cards can have a title, cover, description, and buttons that open links or send text; you can reorder the buttons. 4. Save the template. You can edit, duplicate, or delete it later, and send a preview to your own Mixin account. Templates belong to the current circle. In a welcome card, introduction card, or auto-reply editor, choose **Use a template** to copy compatible content into the editor; review and save that page to apply it. You can also save the page's content first and choose **Save as template**. Copies are independent: editing or deleting a template later does not change saved cards, auto-replies, or broadcast history. ## Send a broadcast 1. Open **Console → Chat → Broadcasts** and choose **New broadcast**, or start a broadcast from a template in the library. 2. Choose a template from this circle and select the audience. **All members** includes the owner, admins, lecturers, and members; you can also select individual roles, including followers and expired members. 3. Check the estimated recipient count and use **Send test to me** to check the content in Mixin. A test does not create a broadcast record. 4. Choose **Send now** and confirm. The content and recipients are fixed at confirmation and cannot be edited after sending. 5. Open the broadcast details to see its status, counts, and failure reasons. People who have turned off circle messages are excluded. If the circle pauses messages for inactive members, those currently paused are also excluded. The recipient list is fixed when you confirm. ## Check results, stop, or recall The details page shows targeted, sent, failed, not sent, delivered, and read counts. **Delivered and read counts only include receipts reported by Mixin clients, so the actual numbers may be higher.** Only totals are shown, not individual read status. Check the failed list for reasons a message was not sent. You can **stop** a broadcast while it is in progress; messages already queued may still arrive. Once it has finished, you can **recall** it within the permitted time. Recall is processed in the background and may be rejected by Mixin. A broadcast here is a one-time send, separate from [Broadcast chat mode](/en/creator-guide/chat-modes-for-owners). See also [Chat modes and auto-replies](/en/creator-guide/chat-modes-for-owners) and [The welcome experience](/en/creator-guide/welcome-experience). --- #### Money: orders & payouts > The full life of an order from creation to completion, how to read your income, and how the money reaches you. > > Source: https://docs.ohmy.xin/en/creator-guide/money-orders-payouts/ Console → **Money** is the financial hub: the order list and the VIP upgrade entry live here; the **Today** and **Insights** pages show income at a glance. ## The life of an order 1. A member starts a purchase and the order is created in the Waiting state, **valid for 15 minutes**, then expires automatically. 2. The member pays; once the amount is verified the order is marked Paid — membership or tier access starts immediately and you get a notification. 3. Settlement then completes automatically: the platform takes its 10% service fee, the inviter bonus (if on) is shared with the inviter, and the rest is sent straight to your own Mixin wallet through the platform's Mixin Safe — usually within seconds to a few minutes. There is nothing to withdraw. [See how one payment splits →](/en/reference/pricing-and-fees#where-each-payment-goes) Payment problems are rejected explicitly: an amount too low (underpayment), a trace id that doesn't match (paid on the wrong order), or the wrong recipient. Those payments never take effect — the platform verifies them and returns the money to the member, the same way it came. ## Finding orders Money → Orders: filter by status (Paid / Completed / Expired), search by order number, trace id, member Mixin ID, or name, and scope to the last 7 / 30 / 90 days. Every order can be matched back to the original Mixin transfer through its trace id. [Screenshot: The console Orders page] ## Reading income trends - The **Today** page's Pulse: income and order counts for the last 14 days. - **Insights** → Statistics: income charts (order income, red packets, and tips — visible for paid circles), with USD conversion. ## Membership gifts Members → Membership gifts: extend a specific member's membership for free. Fill in the recipient, duration (months), how it's counted (straight duration or the next calendar month), and a reason. The action is kept in an audit log. ## If something goes wrong - **The order shows Expired but the member says they paid** — ask the member for the trace id and check it in order search. When a payment doesn't match its order, the order never takes effect and the platform returns the money to the member after review. - **Income hasn't arrived** — after each order is paid, the platform immediately transfers your share (total minus the 10% fee and any inviter bonus) straight to your Mixin wallet, usually within seconds to a few minutes; if it's late, look up the transfer in Mixin using the order's trace id. ## Related pages - [Membership & pricing](/en/creator-guide/membership-and-pricing) - [Pricing & fees at a glance](/en/reference/pricing-and-fees) --- #### Settings reference > A quick reference to every section and field on the Settings page, plus the staged publish and undo mechanism. > > Source: https://docs.ohmy.xin/en/creator-guide/settings-reference/ Console → **Settings** holds every circle setting members experience. Two more cards sit at the top: bot connection and danger zone. ## Sections at a glance | Section | Fields | | --- | --- | | Profile & language | Circle language (the language of pages and bot notifications) | | Appearance | Layout and layout customization ([Choosing your layout](/en/creator-guide/choosing-your-layout), [Customize Story Hub](/en/creator-guide/customize-story-hub), [Customize Trading Hub](/en/creator-guide/customize-trading-hub), [Home entries](/en/creator-guide/home-entries)); shareable post cards; post tags (up to 20); trading entry and types (Trading Hub) | | Entry & pricing | Who can join; fee currency; entry price; billing period; membership lengths; renewal discount (0–99%); inviter bonus; pricing mode; trial days (0–365) | | Visibility | Circle visibility; browse mode (preview requires a paid circle); post and article visibility | | Welcome & onboarding | Welcome message; introduction card; welcome card buttons (primary + grid up to 18, labels ≤20 chars, link or send-text); auto-enroll on first message; skip contact greeting; community guidelines (Chinese and English) | | Announcements & support | Notice bar and notice text (up to 200 characters); support contact | | Group chat rules | Message cooldown (seconds); link / image / voice / card filtering | | Spark points | Points system toggle; whether chat messages count (see [Spark points](/en/creator-guide/spark-points)) | | Spam protection | Spam protection toggle; strictness; link policy; new-member message threshold; opt out of cross-circle scanning | | Member policy | Inactivity warnings (7–365 days, 0 to disable); anonymous mode; admins can see real identities; hide member count and the member list | | Content & posting | Who can post; whether questions are allowed | "Hide member count" also hides the member list: members and visitors see only the admin team, while the owner and admins always keep the full list. There is also a **bot profile** card: the bot's display name on Mixin (up to 36 characters), description (up to 512 characters), and avatar (up to 512 KB). Red-packet risk controls, invite promotion, campaign permissions and the like live on their own dedicated pages, not in this table. [Screenshot: The bot profile card on the Settings page: the avatar, name, and description form for a connected bot] The form only appears once the bot is connected; before that this spot holds a notice and a "Connect" button. Saving syncs the name, description, and avatar to the bot's Mixin profile. ## Staged publishing & undo - Changes are staged first: the page shows a count of staged (unsaved) items, and clicking **Review changes** walks you through the impact field by field (a price change, for example, cites the last 7 days of renewal data) before anything is published. - **When admins change settings involving fees or permissions they must provide a reason** — the reason is recorded and sent to the circle owner (owners themselves are exempt). - Every change is written to the **History**: settings-publish operations support one-click undo (if the field was edited again afterwards, the undo warns you that it has drifted). ## Try it here The sections table is for looking things up; staged publishing is for walking through: change a field, review the per-field impact, hit the admin reason requirement, publish into History, then undo — and meet the drift warning. ## Related pages - [Membership & pricing](/en/creator-guide/membership-and-pricing) - [Content moderation](/en/creator-guide/moderation) --- #### Showcase pages & cards > In the Trading Hub, pages collect cards by tag and the tab bar carries pages to members — configure it once here and it clicks. > > Source: https://docs.ohmy.xin/en/creator-guide/showcase-pages-cards/ A suggested order of experiments: - Turn off the "teacher" filter tag on the Faculty page — the phone page empties out with "No cards match". - Turn off every filter tag — the page switches to showing all four cards (rule 2). - Give "Beginners lounge" the "teacher" display tag — it appears on the Faculty page at once. - Set Slot 1 to "Empty" — the matching tab disappears from the phone; hit "Preview" and the page shows a ⚠ warning: members can't reach it (rule 3). - Cycle a card's "Tap action", then tap that card in the phone to see detail page, contact, link, and nothing happen in turn. ## The two card styles | | Person card | Group card | |---|---|---| | Image | Avatar | Cover | | Data | Win rate (0–100), sessions | Highlights (≤3, ≤40 chars each) | | Badge | — | VIP | | Default button | View profile | Contact assistant | | Special use | Can be credited as a course **speaker** | Services and groups | A person card can bind a circle member — the avatar, name, and contact card come straight from them; without one, fill in a "Contact Mixin ID" instead. Deleting a card removes it from every page and from course speaker credits. ## What happens when a card is tapped When a member taps a card, the action is picked in this order — **each step only applies if everything above it is blank**: 1. **Detail page content** — opens the card's detail page; 2. **Bound member / contact Mixin ID** — opens the Mixin contact card; 3. **Link URL** — opens the external link; 4. None of the above — the tap does nothing. Leave the button label blank to use the style's default (person "View profile", group "Contact assistant"). ## Other page settings - **Arrangement** — grid (two columns) or list (one column); flip it and watch the phone; - **Subtitle / intro strip / footnote strip** — small text under the title, above the cards, and below the cards; - **Sort order** — where the page sits in the console list. ## Don't forget the tab bar Creating the page is step one; pin it to the tab bar under "Settings → Appearance → [Layout customize](/en/creator-guide/customize-trading-hub)": - at most three middle slots; a blank slot label falls back to the page title; - delete the page and its tab disappears with it; - slots aren't the only entrance: a [home entry](/en/creator-guide/home-entries) card can jump straight to a showcase page using its numeric ID. ## Common confusions - **Created a card, but the page is empty?** The card's display tags and the page's filter tags don't intersect. Give the card the tag the page uses. - **Members can't find the page?** It isn't pinned to the tab bar. Give it a slot in layout customize. - **Want one card on several pages?** Give it several display tags, or let the pages share one filter tag. - **Can the win rate be 120?** No — only numbers from 0 to 100. The Trading Hub layout itself requires [Circle VIP](/en/reference/pricing-and-fees). ## Related pages - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Home entries](/en/creator-guide/home-entries) - [Choose your layout](/en/creator-guide/choosing-your-layout) - [The four layouts, member's view](/en/member-guide/layouts) --- #### Spark points > How member activity scores, how levels unlock, and how red packets gate by Spark — every rule and toggle of the engagement system. > > Source: https://docs.ohmy.xin/en/creator-guide/spark-points/ Spark is the points system that rewards members for showing up. It is on by default and works without any setup. Members only ever see their own points — there is no public leaderboard. ## How points are earned | Action | Each | Daily cap | | --- | --- | --- | | Reading a post / article / story | 1 | 3 | | Reacting or voting | 1 | 3 | | Commenting | 2 | 3 | | Posting | 3 | 2 | | Sending a group-chat message | 1 | 3 | - Across all actions, at most **10** qualifying actions count per day. - A read only counts after the page stays visible for about 5 seconds, and the same content doesn't count again for 90 days. - Whether chat messages score can be switched off separately (see the toggles below) — handy if you only want points from reading, reacting, commenting, and posting. Bot and system messages never count. ## Streaks and levels - The first qualifying action of each day keeps the **streak** alive and adds a bonus equal to the streak length (capped at 7). Miss a day and the streak resets; lifetime points and level are untouched. - Lifetime points light up five crown levels. Each member sees their own total, streak, and level on the Mine page: | Level | Name | Lifetime points | | --- | --- | --- | | 1 | Ember | 0 | | 2 | Kindling | 40 | | 3 | Flame | 150 | | 4 | Blaze | 500 | | 5 | Beacon | 1200 | ## What you configure The Settings → **Spark points** section holds just two toggles, each with its own helper text on the page: - **The first toggle** runs the whole points system — "Turn on to let members earn points from circle activity. Their total, streak, and level show on profile (Mine). Turn off to pause earning; saved points stay." On by default. - **The second toggle** decides whether chat messages count — "Include ordinary chat messages in the points system (on by default). Turn off if you only want points from reading, reactions, comments, and posts." The other place Spark matters is [luck campaigns](/en/creator-guide/luck-campaigns): a red packet can target "by Spark" so only members at or above a chosen level can claim it — an exclusive perk for your active regulars. ## Try it here The console below recreates all three things you configure: the two toggles and the red-packet audience. The right side is a sample roster with very different lifetime totals — change any setting and watch who can claim the packet, and whether chat still scores, land on the roster and the preview instantly. Points can't be spent, transferred, or cashed out; they record participation and unlock levels. ## Related pages - [Luck campaigns: red packets, lotteries, and quizzes](/en/creator-guide/luck-campaigns) - [Members and roles](/en/creator-guide/members-and-roles) - [Settings reference](/en/creator-guide/settings-reference) --- #### Story feeds > Subscribe to external content sources and pull them into your circle automatically — adding sources, per-source settings, and the publishing queue. > > Source: https://docs.ohmy.xin/en/creator-guide/story-feeds-and-sources/ Story feeds are the core of the [Story Hub layout](/en/creator-guide/choosing-your-layout): they pull external content (X, YouTube, Telegram, Discord, Bilibili, Weibo, GitHub, Hacker News, Zhihu, Medium, and more) into your circle continuously. A [Circle VIP](/en/creator-guide/circle-vip) feature. ## Adding a source Console → **Content** → **Sources** → Add — a three-step wizard: 1. Pick a category (social, trading signals, video & live streams, articles & news, and more). 2. Pick a source — choose from the platform-maintained source catalog (or paste a profile or channel link and it is recognized automatically). Fetch frequency differs by source (an X user timeline runs about every 2 minutes, video sources about every hour). 3. Preview the recent content, then click **Add to circle** to confirm. ## Per-source settings - **Auto-publish** — on, content goes straight to the timeline; off, it is saved as a draft and lands in [Review](/en/creator-guide/moderation) under "Stories waiting to publish" for you to approve one by one. - **Notify members of new stories** — pushes new content to members subscribed to this source (shown only on layouts other than Story Hub). - **Visibility level** — Public / Trial / Members only. - **Display info** — name (up to 120 characters), description (up to 2,000 characters), tags (up to 5 × 20 characters), icon (up to 5 MB), Featured flag and ordering. - **Editorial groups** — custom group names that bundle sources into sections members can browse easily. ## Day-to-day upkeep - Each source can be fetched manually (**Fetch**, 5-minute cooldown); sources that keep failing to fetch show up in Review under "Failing sources". - Console → **Content** → **Stories**: publish drafts, hide, edit tags, and send content into the group chat. ## Try it here Fetch once from each demo source: the auto-publish one lands straight on the member timeline, the other parks in Review until you tap Publish in the queue. Fetching starts a 5-minute cooldown (fast-forward to clear it), and switching on "Simulate constant failures" drops the source into "Failing sources". ## Advanced: cross-circle publishing Trading Hub circles can publish their own posts and strategies as sources for other circles to subscribe to ("cross-circle picks", "cross-circle strategies"), letting good content travel. ## Related pages - [Choosing your layout](/en/creator-guide/choosing-your-layout) - [Content moderation](/en/creator-guide/moderation) --- #### Welcome experience > Everything new members see in their first moments in the circle — welcome card, intro, community guide, and auto-join. > > Source: https://docs.ohmy.xin/en/creator-guide/welcome-experience/ Find it in Console → Settings → Welcome & onboarding. This is where you decide what new members receive after they join. ## The three building blocks - **Welcome message** — a direct-message welcome card sent once when a member joins. - **Intro card** — what the circle does and what its rules are, visible the moment new members step in. - **Community guide** — fuller instructions for using the circle, with separate Chinese and English versions you maintain separately. [Screenshot: The Welcome & onboarding section of console Settings] The welcome card carries a **primary button** (default "Open the circle", straight to the circle home) plus a set of **grid buttons** (label ≤20 characters, primary + grid up to 18 in total). Each button is one of two kinds: a **link** (an `https://…` page or a `/` circle path) or **send text** (posts the given text as the member — if it matches an auto-reply trigger, the bot picks it up for another layer; see [Playbook: bot onboarding](/en/playbooks/bot-onboarding)). After configuring, use the preview feature to send it to your own Mixin and check how it looks. The intro card (what visitors see) takes the same button configuration. When a link button points at a **new external domain**, saving pops a confirmation: Mixin Messenger only opens card buttons whose host is whitelisted in the bot's profile, so the platform adds those domains to the whitelist for you before saving. That's Mixin's safety mechanism at work — nothing to configure by hand. Lower in the same section sits the **cover** — the app card image shown when a post is shared to Mixin (≤5 MB). ## Auto-join Free circles can turn on "Auto-enroll on first message": anyone who messages the bot becomes a member automatically, skipping the join button. Under the Community Hub layout this option is forced off. ## What new members receive When a member joins, things arrive in order based on your setup: welcome card → [starter pack](/en/creator-guide/content-toolkit) (Story Hub layout, up to three featured story source cards) → new-member red packet (if you published a red packet only newcomers can claim) → and in Group mode, a quick recap of recent content. ## If something goes wrong - **The welcome card never arrived** — check that the welcome message was saved. It's sent only once, at join time; editing the text doesn't affect members who already joined. - **Buttons don't open** — for link buttons, check the address is complete (starts with `https://`, or a `/` path inside the circle) and that the external domain went through the whitelist confirmation when you saved; for send-text buttons, check the text to send is filled in. ## Related pages - [Launch checklist](/en/creator-guide/launch-checklist) - [Playbook: bot onboarding](/en/playbooks/bot-onboarding) - [Membership & pricing](/en/creator-guide/membership-and-pricing) ### Playbooks / 实战手册 #### 'Playbook 1: bot onboarding' > Welcome-card buttons + send-text actions + auto-reply triggers — a multi-layer guided flow, zero code. > > Source: https://docs.ohmy.xin/en/playbooks/bot-onboarding/ A member's first minute in your circle decides their second. This playbook combines three bot-layer features into a **multi-layer guided flow**: welcome-card buttons, the send-text action type, and auto-reply triggers. It all happens in chat and works with any layout. **The idea**: besides opening links, a welcome-card button can **send text** — it posts a message as the member. If that text happens to be an auto-reply trigger, the bot answers. Button → trigger → reply card → the card carries more buttons, and a guidance tree grows. The left side simulates the console configuration (welcome-card buttons + auto-reply rules); the right side is the conversation members see. Tick "X-ray" to see the rule behind each message. Try: "Start here tour" → "Find content" → "Open the circle home". ## How it works 1. A member joins; the bot delivers the **welcome message and card** (Settings → Welcome & onboarding). 2. The card has a **primary button** (default "Open the circle", linking to `/`) plus grid buttons. Each button is one of two kinds: - **Link** — opens an `https://…` page or a `/` circle path; - **Send text** — posts the given text into the conversation as the member. 3. That text **exact-matches an auto-reply trigger** (case-sensitive; one rule can carry several triggers, comma-separated), and the bot replies with text, a post, a contact card, or an app card with buttons. 4. App-card buttons support send text too — so the tree keeps going. When one trigger has several rules, **the first created wins**. ## Four steps for the owner 1. **Draw the tree before touching the console.** Two layers usually suffice: entry buttons (2–3) + a second-level menu under each. Pick a trigger word per entry — it appears on the button and is the message members send, so make it readable ("tour", "help"). 2. **Configure the welcome card.** Console → Settings → Welcome & onboarding: keep the primary button as "Open the circle", put your entries in grid buttons with kind **send text**, value = the trigger. Labels ≤20 chars, primary + grid ≤18 buttons total. Preview it to your own Mixin before saving. 3. **Configure auto replies.** Console → Group chat → Auto replies — one rule per entry: trigger = the text the button sends; reply with an **app card** (title ≤36, description ≤1024, up to 18 buttons, labels ≤36). Leave the leaves to lighter types: link buttons for help docs, a post for long tutorials, a contact card for human support. 4. **Always leave a human exit.** End every menu with a "contact an admin" send-text button pointing at a contact-card reply — members who can't find an answer need a way out. :::note[Maintenance cost] Deeper trees cost more upkeep. Put long content in posts or help docs and reach them with link buttons — later you edit the doc, not the tree. A trigger that collides with a platform command (like `/help`) overrides it in your circle; the console warns you, so just avoid command-style names. ::: ## Variations - **Paid circles**: add a "See plans" link button on the welcome card straight to the membership page — an entry inside the chat converts faster than hoping members find the pricing page. - **Passphrase play**: use a send-text button as a passphrase that triggers a resource post or a red packet — your active members will spread it for you. - **English circles**: triggers are case-sensitive; lowercase trigger words (`tour`, `help`) save everyone the guessing. ## Related pages - [The welcome experience](/en/creator-guide/welcome-experience) - [Chat modes and auto-replies](/en/creator-guide/chat-modes-for-owners) - [Home entries](/en/creator-guide/home-entries) --- #### 'Playbook 2: the newcomer path in Story Hub' > Starter pack, a home-entry folder, the notice bar, and a pinned post — one content route for the first three minutes. > > Source: https://docs.ohmy.xin/en/playbooks/newcomer-content-path/ **Circle**: Daily Notes — a markets-explainer news circle (Story Hub layout, Circle VIP). **Problem**: the content is good, but newcomers are lost: the feed scrolls, sources scatter, and many never see their first genuinely useful piece — then go quiet. **Goal**: within three minutes of joining, a new member has received a starter set of content, knows where things live, and knows what to do next. ## What members experience 1. **The moment they join**: the bot delivers the welcome card (primary button opens the circle home), followed by the **starter pack** — three featured source cards; tap to follow. 2. **Opening the home**: a banner with the circle name, a notice-bar line ("new here? start with Start here"), and the first directory folder: **Start here** — the onboarding guide, a learning-path collection, one curated source. 3. **After the guide**: the pinned post "Three steps to get settled" — follow the picks, choose sources, say hi in a channel. 4. **When they're ready to pay**: a "Membership" entry sits right beside the folder, one tap from the purchase page. ## What the owner does | Step | Where | What | | --- | --- | --- | | 1. Pick starter sources | Content → Story sources | Feature your three most representative sources as the **starter pack**, sent automatically on join | | 2. Write the guide | Content → Posts | One pinned "three steps" post explaining how the content is organized | | 3. Build the home folder | Settings → Appearance → Customize → Home entries | Top-level "Start here" folder: the guide + a learning-path collection + one curated source; a "Membership" entry beside it | | 4. Set the notice bar | Settings → Notice bar | One line pointing at Start here, persistent site-wide | | 5. Align the vocabulary | Settings → Appearance → Customize | Rename "sources"/"stories" if they don't fit — home copy and entries follow | :::note[Why this combination] The starter pack answers "something to read right now", the folder answers "where things live", the notice bar and pin answer "what's next", and the membership entry answers "where do I pay". Four jobs, four homes — no single feature has to carry it all. ::: ## Variations - **Circles with trial content**: set the learning-path collection to **trial visibility** so non-members read the first few articles — the directory itself becomes the conversion entry (see visibility levels in the [content toolkit](/en/creator-guide/content-toolkit)). - **Circles with an archive**: add a second "Archive" folder and keep Start here first — newcomers find their way, veterans find the back catalog. ## Related pages - [The welcome experience](/en/creator-guide/welcome-experience) - [Home entries](/en/creator-guide/home-entries) - [Customize Story Hub](/en/creator-guide/customize-story-hub) - [Story feeds and sources](/en/creator-guide/story-feeds-and-sources) --- #### 'Playbook 3: the Trading Hub storefront' > Showcase pages, channel order, and home entries — fitting out the circle as a services front desk. > > Source: https://docs.ohmy.xin/en/playbooks/trading-hub-storefront/ **Circle**: Starsea Trading Room — a strategy-services trading circle (Trading Hub layout, Circle VIP). **Problem**: strategies, courses, and services live in separate console corners; members land on the default channel order and paid content sits three taps deep — great service, invisible storefront. **Goal**: members reach paid content within three taps; the free parts build trust and the paid parts convert. ## What members experience 1. **Opening the home**: **Strategies** — the live signal panel — is the first channel tab: the core capability front and center. Above it, a pill row of three quick entries: **Strategy services** (straight to a showcase page), **Market glance** (external link), and **Starter course** (article collection). 2. **Tapping Strategy services**: a **showcase page** collecting persona cards by filter tag — each card carries its win rate and trade sessions, so the team's track record reads at a glance. 3. **The bottom tab bar**: the second tab is the services page — one tap back from anywhere; its label just reads "Services". 4. **A nudge of curiosity**: a few locked posts sit in the feed, unlocked by an inviter code — every existing member holds a letter of recommendation. 5. **Live reminders**: subscribed members get a ping before the weekly live class; the course calendar is the second channel tab. ## What the owner does | Step | Where | What | | --- | --- | --- | | 1. Build persona cards | Settings → Appearance → Customize → Showcase cards | A card per analyst: tags (strategy style) + win rate + trade sessions | | 2. Build the services page | Same sheet → Showcase pages | The "Strategy services" page; filter tags decide which cards land on it | | 3. Order the channels | Same sheet → Layout | Put **Strategies** in slot 1, Courses in slot 2; rename channels if you like | | 4. Take a tab slot | Same sheet → Layout | Point a bottom-bar slot at the services page, label it "Services" | | 5. Lay the quick entries | Same sheet → Home entries | Pill row: showcase page (its numeric ID) + a market link + the course collection | | 6. Plant the hook | Content → Posts | A few high-quality locked posts (inviter-code unlock) — a reason for members to invite | :::note[Storefront logic] Channel order answers "what are you best at", the showcase page answers "why trust you", the pill row and tab slot answer "where's the paid stuff", and locked posts answer "why join now". One home each — don't pile the whole pitch onto a single card. ::: ## Variations - **Free first, paid after**: keep the Strategies channel public (that's the trust) and set course content to members-only — the channels themselves become the price list. - **No live classes**: give that channel slot to Strategies or the square — the three channel slots don't need filling; empty slots collapse away. ## Related pages - [Customize Trading Hub](/en/creator-guide/customize-trading-hub) - [Showcase pages and cards](/en/creator-guide/showcase-pages-cards) - [Home entries](/en/creator-guide/home-entries) - [Membership & pricing](/en/creator-guide/membership-and-pricing) --- #### 'Playbook 4: the Community Hub tool station' > Bot entries, external links, and single-target folders — the member home as a directory page. > > Source: https://docs.ohmy.xin/en/playbooks/community-tool-station/ **Circle**: Toolbox — a community aggregating Mixin-ecosystem tools (Community Hub layout, free). **Problem**: the community's value is connecting people with the right tools, but the tools live in a dozen bots and answers travel by word of mouth. **Goal**: opening the circle gives members a tool directory — the bots they need, one tap away; the owner maintains one list and the whole group benefits. ## What members experience 1. **Opening the home**: no feed — the home page *is* the entry grid: market bot, airdrop-calendar bot, support bot, and two frequently used links, ordered by how often they're used. 2. **Tapping any card**: bot entries jump straight into that Mixin bot's conversation; links open the web. 3. **Visitors who haven't joined**: they see the **introduction card** — the owner's blurb plus buttons to the two most-used tools. 4. **A persistent note**: the notice bar up top announces this week's new tools. ## What the owner does | Step | Where | What | | --- | --- | --- | | 1. Collect the bots | Content → Friendly links | Add the ecosystem's bots as friendly links with descriptions and tags | | 2. Lay the home | Content → Home entries | Top-level **bot entries** (picked from friendly links) and **external links**; order by usage | | 3. Tuck the rarely used | Same page | Put occasional tools in a folder — in Community Hub folders group backstage only, members see top-level entries; **a folder with a single target jumps straight there**, which makes it a nice "alias" | | 4. Write the intro card | Settings → Welcome & onboarding | The visitor card gets a blurb and link buttons to two flagship tools | | 5. Announce | Settings → Notice bar | One line for this week's additions, pinned to the top | :::note[What's special about Community Hub] No channels, no customize sheet — but the home-entry grid *is* the whole storefront, which makes it the purest "directory page": no content treadmill, just one maintained list. Bot entries must exist as friendly links first — that's the only dependency. ::: ## Variations - **Pair it with auto replies**: add an auto reply triggered by "tools" that answers with an app card of new tools — when someone asks in chat, the bot answers for you (see [playbook 1](/en/playbooks/bot-onboarding)). - **Self-service**: add "Orders" and "Profile" entries so members handle their own errands without an admin. ## Related pages - [Home entries](/en/creator-guide/home-entries) - [The content toolkit (friendly links)](/en/creator-guide/content-toolkit) - [The welcome experience](/en/creator-guide/welcome-experience) - [Chat modes and auto-replies](/en/creator-guide/chat-modes-for-owners) --- #### Playbooks > Four complete makeovers — combining circle features to solve real operating problems. > > Source: https://docs.ohmy.xin/en/playbooks/ The guides earlier in this site explain features one by one; this section flips it around and **starts from the problem**: what member experience you want, which features combine to deliver it, and where each is configured. Every playbook follows the same structure: - **Goal** — the problem this circle needs to solve; - **What members experience** — the full journey from a member's point of view; - **What the owner does** — each step with its console entry point and key parameters, linking to the matching guide page for details; - **Variations** — a cheaper cut, or one step further. The circles and numbers in the playbooks are fictional demo data. Each playbook matches a typical community: - [Playbook 1: bot onboarding](/en/playbooks/bot-onboarding) — welcome card + send-text buttons + auto replies make a multi-layer guided tree (works in every layout) - [Playbook 2: the newcomer path in Story Hub](/en/playbooks/newcomer-content-path) — starter pack, home entries, and the notice bar strung into one content route - [Playbook 3: the Trading Hub storefront](/en/playbooks/trading-hub-storefront) — showcase pages, channels, and home entries composed into a services front desk - [Playbook 4: the Community Hub tool station](/en/playbooks/community-tool-station) — bot entries and links turn the home page into a directory Want a single feature first? Back to the [creator guide](/en/creator-guide/). ### Reference / 参考 #### Bot commands > Every command the circle bot understands — grouped by role, with usage and limits. > > Source: https://docs.ohmy.xin/en/reference/bot-commands/ Send a command in the circle chat to trigger it. **/block, /recall, /report, and /reveal require you to quote a message first** — quote the target message, then send the command. Can't remember them? Send `/help` and the bot replies with quick-action buttons for your role. ## Try it Pick who you are and tap a command — the replies are the bot's own words. Switch roles to see which commands unlock. ## Available to all members | Command | What it does | | --- | --- | | `/help` | Shows the quick-action buttons for your role | | `/guide` | Get the circle guide (members receive a welcome card, the admin team receives the guide link) | | `/vote post-number\|option-number` | Vote in a single-choice poll post, e.g. `/vote 12\|1` (for multiple-choice polls, vote on the web) | | `/lottery post-number` | Enter a lottery post | | `/report` | Quote a message to report spam (member role only; requires spam protection to be enabled in the circle) | ## Lecturers and admins also get | Command | What it does | | --- | --- | | `/default` | Switch to Default mode | | `/lecture` | Switch to Lecture mode (starts recording the replay) | | `/qa` · `/qa on` · `/qa off` | Check or toggle lecture Q&A (the reply comes as a private message when no lecture is running) | ## Admins only | Command | What it does | | --- | --- | | `/broadcast` | Switch to Broadcast mode | | `/group` | Switch to Group mode (requires [Circle VIP](/en/creator-guide/circle-vip)) | | `/block` | Quote a message to block that member | | `/recall` | Quote a message to recall it (works within 30 days) | | `/reveal` | Quote a message from an anonymous member to verify the sender's real identity (only available when anonymous mode is on; the result is sent as a private message, never made public) | ## Notes - Mode switches take effect for the whole circle immediately; the bot sends a private message to members who subscribed to messages. - Oh My Luck activities have no chat commands — red packets, lotteries, and quizzes are all joined on the web. ## Related pages - [Roles & permissions](/en/reference/roles-and-permissions) - [Chat modes & auto-replies](/en/creator-guide/chat-modes-for-owners) --- #### FAQ > Answers to the questions new users ask most. > > Source: https://docs.ohmy.xin/en/reference/faq/ The short answer is under each question. Open one for the details. ## Getting started **Do I need to understand crypto first?** > No. Your wallet only comes in when you pay for something. Signing up, reading posts, and chatting never touch your wallet. It only comes into play when you pay for a membership or join an activity, and the interface walks you through it. **How much does joining a circle cost?** > Free circles cost nothing. Paid ones show their price on the plan page. Paid circles charge what the owner set, usually monthly or yearly; the exact amount is on the circle's plan page. The full picture lives in [Pricing & fees](/en/reference/pricing-and-fees). **How long until a payment activates?** > Seconds. Membership activates within seconds. If it doesn't, look up the payment with its Trace on the order page, or contact the circle admin. **Why do I see “Please upgrade your Mixin Messenger”?** > Your Mixin Messenger is too old to receive transfers. Update it. Receiving red packets, tips, or prizes needs a recent Mixin Messenger version. Update from the app store and reopen the page. ## Money **Does running a circle cost anything?** > Running one is free. The platform takes 10% of each membership or member tier order. Luck campaigns (red packets, lotteries) take nothing. Circle VIP is an optional subscription (monthly, quarterly, or yearly). See [Pricing & fees](/en/reference/pricing-and-fees). **How do circle owners withdraw?** > They don't have to. Each order's share lands in their wallet automatically. When each order completes, the platform automatically sends the owner's share (minus the 10% fee and any inviter bonus) as a direct Mixin transfer, usually arriving within seconds to minutes. See [Money: orders & payouts](/en/creator-guide/money-orders-payouts). **Where do red packets and tips land?** > In your Mixin wallet, usually within seconds. Red packet claims arrive in seconds, and the platform forwards tips in full with no platform cut. If money seems missing, update Mixin Messenger first, then check the transfer with its Trace. **What happens when Circle VIP lapses?** > What's already on keeps running. You just can't turn on new VIP features. You can't switch into new VIP features (like the VIP layouts or Group mode). Renewing extends from the expiry date and restores everything, see [Circle VIP](/en/creator-guide/circle-vip). ## Privacy & help **Can others in the circle see my messages?** > Only in Group mode. In the other modes, only the admin team sees them. It depends on the circle's chat mode: in Default, Broadcast, and Lecture modes your messages go to the admin team only (in Lecture mode the admins' posts reach everyone); in Group chat everyone sees everything. The bot messages you the current mode when you join — see [Chatting in your circle](/en/member-guide/chatting). **Will my identity be exposed?** > Not in anonymous mode. Admins can check privately but never publish it. With anonymous mode on, regular members post anonymously; admins can verify an identity privately when needed, but never publish it. Spam and flooding get withheld, recalled, or blocked. **How do I get help?** > Ask the circle's admins, or send “support” to OhMyBot. Circle admins can help with anything inside their circle. For the platform itself, send "support" to OhMyBot, the official OhMy.xin bot in Mixin Messenger, and it replies with a contact card for the help desk. The [troubleshooting guide](/en/reference/troubleshooting) solves the most common problems step by step. --- #### Glossary > Every term used in the OhMy.xin guide — Chinese and English side by side. > > Source: https://docs.ohmy.xin/en/reference/glossary/ Every term the guide uses, with its Chinese name. Filter by typing in either language, or jump to a topic. Across the guide, words with a dotted underline show these same definitions when you hover over or tap them. --- #### Payments deep dive > The full path a payment travels from checkout to settlement — statuses, rejection reasons, refunds, and lookups. > > Source: https://docs.ohmy.xin/en/reference/payments-deep-dive/ This page lays out exactly how money moves through OhMy.xin. For amounts and rates, [Pricing & fees at a glance](/en/reference/pricing-and-fees) is the source of truth. ## The life of a membership or tier fee 1. **Order** — the member picks a plan and an order is created, **valid for 15 minutes**; it expires automatically after that. 2. **Payment** — the member pays through the Mixin payment page (QR code or deep link); they can also choose "Pay with other assets" to settle through Mixpay at the live exchange rate. 3. **Confirmation** — the platform polls Mixin transfer records and usually detects the transfer within seconds (at most about half a minute), then matches the payment note (handled automatically — nothing to enter by hand). 4. **Activation** — membership or tier access starts immediately; settlement then follows: the platform takes a 10% platform service fee, the inviter bonus goes to the inviter, and the remainder is paid out directly to the circle owner's Mixin wallet via a platform-initiated safe transfer, usually within seconds to a few minutes. Member tier orders take the same path — fee, inviter bonus, payment memo, and settlement are identical. ## Order statuses | Status | Meaning | | --- | --- | | Awaiting payment | Ordered but not yet paid; the 15-minute countdown is running | | Paid | The transfer is confirmed and membership or tier access is active | | Completed | Settlement and payout are done | | Expired | Time ran out without payment; nothing to do | ## Rejections & refunds A transfer that arrives but doesn't match an order is rejected — it never takes effect — and is refunded to the sender after a manual review by the platform. Common reasons: - **Underpayment** — the payment is less than the order amount. - **Trace mismatch** — the transfer doesn't correspond to any order awaiting payment (for example, paying for the same order twice). - **Wrong recipient** — the transfer's recipient details don't match the order. Refunds for mismatched payments go out after the platform's manual review, which takes some time — contact support with the Trace if you're waiting on one. These refunds, on the other hand, are automatic: the unclaimed portion of an expired red packet returns to its creator, and the un-won portion of a lottery pot returns to whoever funded it. ## How to trace a payment - **Order details** — members open any order under **Mine** → Orders to see its **Trace** and jump straight to Mixin to view the original transfer; circle owners search Money → Orders by order number, trace id, or member. - Every transfer's Trace is globally unique — the anchor for all reconciliation. ## Related pages - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [Money: orders & payouts](/en/creator-guide/money-orders-payouts) --- #### Pricing & fees at a glance > The single source of truth for every number on the site — platform service fees, Circle VIP prices, and settlement rules. > > Source: https://docs.ohmy.xin/en/reference/pricing-and-fees/ This page is the single source of truth for every price and fee on OhMy.xin. Numbers on other pages defer to this one; when prices change, only this page needs updating. ## Platform service fees | Item | Rate | Notes | | --- | --- | --- | | Membership / member tier orders | 10% | The share the platform takes from each membership or tier payment; the rest goes to the circle owner | | Red packets / lotteries / quizzes | 0% | All activity funds go to the participants | ## Circle VIP (optional, bought by the circle owner) | Period | Price | | --- | --- | | Monthly | 9.99 | | Quarterly | 29.99 | | Yearly | 99.99 | Payable with BTC, PUSD, USDT, and XIN. The premium features VIP unlocks include: the Story Hub and Trading Hub layouts, Super group broadcast mode, custom accepted assets, Sources, participant filters for lotteries and red packets, video posts, live video streams, and more. ## Inviter bonus Set by each circle owner as a percentage of every membership or tier order, capped at 89%. Set it to 0 to turn it off. The bonus is paid to the existing member who brought that member in — orders from members who joined without an invite pay no bonus, so that share stays with you. ## Where each payment goes Change the price and the bonus to see exactly how one membership or tier payment is split. ## Circle membership pricing Set by each circle owner: a fixed price or several subscription plans, with an optional intro price, renewal discount, and trial days. What a member actually pays is what the circle's plan page shows. **Member tiers (Pro content)** have their own price, currency, and duration, priced separately from entry, and use the same settlement and inviter-bonus rules. Circle VIP is a feature subscription the owner buys from the platform — not the same thing as a member tier. ## Settlement & timing - Payment confirmation: usually takes effect within seconds. - Owner payouts: settled automatically to the owner's wallet when an order completes, usually within seconds to minutes — no manual withdrawal needed. - Payment page validity: 15 minutes; if it runs out, start the payment again. - Order lookups: match an order on the order page using its Trace. ## Related pages - [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) - [Membership & pricing](/en/creator-guide/membership-and-pricing) - [FAQ](/en/reference/faq) --- #### Roles & permissions > Who can do what — a plain-language comparison of console, content, and interaction permissions. > > Source: https://docs.ohmy.xin/en/reference/roles-and-permissions/ What you can do and see in a circle comes down to your role. Pick one below — then switch the circle type to see how much a non-member gets to read. ## All roles side by side Roles from highest to lowest: Owner → Admin → Lecturer → Member → Follower → Expired; plus Blocked as a separate status. Admin and Lecturer are capped at 10 each, and a Trial member has the same rights as a Member. ## Content visibility levels Paid circles split posts, articles, and feed items into three levels: **Public** ⊆ **Trial** ⊆ **Members only**. | Who is viewing | Public | Trial | Members only | | --- | :-: | :-: | :-: | | Admin team & paid members | Full text | Full text | Full text | | Trial members | Full text | Full text | Preview | | Visitors / Followers / Expired | Full text | Preview | Preview | > **This table is Teaser mode** > Paid circles choose a **Browsing Mode** under **Settings → Visibility**. **Teaser** (the table above) lets non-members read public posts and a preview of the rest. **Closed** shows non-members nothing until they join. Free circles are always open; private circles are completely hidden from visitors. > [Screenshot: Browsing Mode in the console settings] ## Member tiers (Pro content layer) Free circles can also sell a member tier. When publishing a post, article, strategy, or public answer, the author can point it at a tier: - **Full text**: the tier holder, the author, the owner, admins, and lecturers. - **Preview only**: everyone else sees a teaser and an unlock card; buying the tier opens the full text immediately. - Tier, role, and circle membership are three independent axes: buying a tier never upgrades a role or extends circle membership. - If circle membership lapses, renew it before you can read tier content, even while the tier is still valid. Remaining tier time is preserved. ## Related pages - [Members & roles](/en/creator-guide/members-and-roles) - [Bot commands](/en/reference/bot-commands) --- #### Troubleshooting index > A symptom → where-to-go cheat sheet, arranged by journey stage. > > Source: https://docs.ohmy.xin/en/reference/troubleshooting/ Two taps to the most likely cause and its fix. Prefer to scan? Every symptom is listed below by stage. ## Joining & access | Symptom | Where to go | | --- | --- | | The invite link won't open | [Join a circle](/en/start-here/join-a-circle) — first make sure Mixin Messenger is installed | | Content shows a lock and won't open | [Buying & renewing membership](/en/member-guide/membership) / [Joining a circle](/en/member-guide/joining) | | You can only see part of the content (preview mode) | The visibility levels table in [Roles & permissions](/en/reference/roles-and-permissions) | | You want to leave or rejoin a circle | [Your account](/en/member-guide/your-account) | ## Payments | Symptom | Where to go | | --- | --- | | Membership didn't activate after paying | [Paying on OhMy.xin](/en/mixin-basics/paying-on-ohmyxin) | | A "please upgrade Mixin Messenger" prompt appears | [Owner income and payouts](/en/mixin-basics/owner-payouts) | | Paid the wrong amount, or the order expired | [Payments deep dive](/en/reference/payments-deep-dive) | | A tip or red packet hasn't arrived | [FAQ](/en/reference/faq) | ## Chat & content | Symptom | Where to go | | --- | --- | | "Sending messages too frequently" | [Chatting in a circle](/en/member-guide/chatting) | | Your message was blocked as spam | [FAQ](/en/reference/faq), or contact an admin | | Can't find the post button | [Posts, polls, questions & articles](/en/member-guide/posts-and-articles) | | Your feed isn't updating | [Story subscriptions](/en/member-guide/story-subscriptions) | ## Circle owners | Symptom | Where to go | | --- | --- | | Key verification failed / auto-setup failed | [Connect to OhMy.xin](/en/creator-guide/connect-to-ohmyxin) | | A feed source fails to fetch | [Story feeds & sources](/en/creator-guide/story-feeds-and-sources) | | VIP about to expire / features locked | [Circle VIP](/en/creator-guide/circle-vip) | | The circle went dormant | [Lifecycle](/en/creator-guide/lifecycle) | | Earnings missing / order issues | [Money: orders & payouts](/en/creator-guide/money-orders-payouts) | None of these solved it? Report it to an admin in the circle, or send "support" to OhMyBot, the official OhMy.xin bot in Mixin Messenger. It replies with a contact card for the help desk. ### Open platform / 开放平台 #### API reference > The open API v1 contract — base URL, authentication, response and error envelopes, pagination conventions, rate limits, and error codes. > > Source: https://docs.ohmy.xin/en/open-platform/api-reference/ The complete integration contract for open platform v1. Every endpoint follows the conventions on this page, and future business endpoints will be mounted under `/api/v1` the same way. ## Endpoint index | Endpoint | Auth | Purpose | | --- | --- | --- | | `GET /api/v1/health` | None | Confirm the service is reachable. | | `GET /api/v1/me` | Required | Inspect the account and key behind the credential. | | `GET /api/v1/strategies` | Required | List publicly visible trading signals. [Details](/en/open-platform/strategies) | | `GET /api/v1/lives` | Required | List publicly visible livestreams. [Details](/en/open-platform/lives) | ## Base URL and versioning - Base URL: `https://ohmy.xin/api/v1` — the "Quick Integration Guide" section at the bottom of the Developer API page shows the base URL of the environment you are on. - Production is served over HTTPS only. - Paths carry a version prefix (`/v1`); if a breaking change ever becomes necessary it ships under a new prefix, with the old version retired on notice. ## Authentication Everything except the health check requires a Bearer key in the request header: ```http Authorization: Bearer omx_live_<8-char-id>_<32-char-secret> ``` - Keys are generated on an account's page in the Developer API area and look like `omx_live_xxxxxxxx_yyyyyyyy…`. - The platform stores only a one-way digest; no page, response, or log ever shows the full secret again. - Once a key is disabled or revoked — or its account is disabled or frozen — the very next request returns `401`. ## Response envelope Successes return `data`, failures return `error`; both carry `meta.request_id`: ```json { "data": { "...": "..." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ```json { "error": { "code": "unauthorized", "message": "Invalid or inactive API credentials." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` `meta.request_id` is the unique tracking ID of the request and also appears in the `X-Request-Id` response header; include it when contacting the platform about a problem. ## Common response headers | Header | When | Meaning | | --- | --- | --- | | `X-Request-Id` | Every response | Same value as `meta.request_id` | | `X-RateLimit-Limit` | After auth | The account's per-minute request ceiling | | `X-RateLimit-Remaining` | After auth and on `429` | Requests left in the current window (`0` when throttled) | | `X-RateLimit-Reset` | After auth and on `429` | Unix epoch seconds when the window resets | | `Retry-After` | On `429` | Suggested wait in seconds | ## Rate limits - Every API account defaults to **60** requests per minute; the platform may raise or lower individual accounts — the Developer API page always shows the value in effect. - The budget belongs to the account: all keys under one account share it. - On top of that, a fallback bucket counts per source IP (default **300** per minute) across all `/api/` traffic from one IP, valid credentials or not. - When throttled you get `429` plus `Retry-After` — wait as advised instead of retrying concurrently. A `429` from the IP-level bucket carries no `X-RateLimit-*` headers, says "Too many requests. Please retry later.", and leaves no call-log record. ## Error codes | HTTP status | `error.code` | Meaning | | --- | --- | --- | | `400` | `invalid_parameter` | A query parameter is invalid. `error.details` lists each offending parameter as `{ "param": "...", "reason": "..." }`. | | `401` | `unauthorized` | Credentials missing or malformed, key disabled/revoked, or its account disabled/frozen (one shared message by design — no specifics). | | `404` | `not_found` | Unknown endpoint path. | | `429` | `rate_limit_exceeded` | Rate limit exceeded. | | `503` | `service_unavailable` | The open API is temporarily switched off platform-wide. | | `500` | `internal_error` | Unexpected server error — include `meta.request_id` when contacting the platform. | > **Why 401 doesn't say why** > A single shared message prevents callers from enumerating key and account states through response differences. The precise failure reason is recorded in the platform's internal call log, which account owners can browse for their own accounts on the Developer API page. > ## Service endpoints ### Health check ``` GET /api/v1/health ``` No authentication; confirms the service is reachable: ```json { "data": { "status": "ok", "version": "v1", "timestamp": "2026-11-15T22:15:00+08:00" }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ### Credential self-check ``` GET /api/v1/me ``` Authentication required; returns the account and key behind the credential: ```json { "data": { "account": { "number": "8392014", "name": "Production Integration", "state": "active", "rate_limit_per_minute": 60 }, "key": { "name": "Primary Key", "masked_token": "omx_live_a1b2c3d4••••••••x9y0", "state": "active", "last_used_at": "2026-11-15T22:14:12+08:00" } }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` `account.state` is one of `active`, `disabled`, `frozen`; `key.state` is one of `active`, `disabled`, `revoked`. ### Unregistered paths Any unregistered `/api/*` path returns the shared `404` envelope instead of an internal error page: ```json { "error": { "code": "not_found", "message": "API endpoint not found." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## Collection endpoints Endpoints that return a list share one contract, so an integration written against one works against the next. ### Shared query parameters | Parameter | Type | Default | Description | | --- | --- | --- | --- | | `limit` | integer | `20` | Items per page, between `1` and `100`. | | `cursor` | string | — | The `meta.pagination.next_cursor` from the previous page. Opaque — send it back verbatim. | | `sort` | string | Endpoint-specific | The endpoint's own documented sort options; the cursor is bound to the sort used. | | `circle_number` | string | — | Restrict results to one circle (up to 32 characters). | | `state` | string | Endpoint-specific | Comma-separated list of the endpoint's own allowed states. | | `updated_after` | ISO 8601 timestamp | — | Lower bound on `updated_at` (inclusive). | Endpoints may add their own filters on top of these — `symbol`, `side`, `published_after`, and `published_before` on strategies; `scheduled_after` and `scheduled_before` on lives. ### Pagination envelope Every collection response carries the same `meta.pagination` block: ```json { "meta": { "pagination": { "limit": 20, "has_more": true, "next_cursor": "eyJzIjoi..." }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `limit` | integer | No | The page size actually applied. | | `has_more` | boolean | No | Whether another page exists. | | `next_cursor` | string | Yes | Cursor for the next page; `null` when `has_more` is `false`. | To fetch the next page, pass `next_cursor` back as `cursor` and keep every other parameter unchanged. Changing `sort` between pages invalidates the cursor and returns `400`. ### Business endpoints - [Strategies list](/en/open-platform/strategies) — `GET /api/v1/strategies` - [Lives list](/en/open-platform/lives) — `GET /api/v1/lives` ## Related pages - [Strategies list](/en/open-platform/strategies) — `GET /api/v1/strategies` - [Lives list](/en/open-platform/lives) — `GET /api/v1/lives` - [Quickstart](/en/open-platform/getting-started) - [Open platform overview](/en/open-platform/) - [OpenAPI spec](/openapi.json) — machine-readable description of every endpoint --- #### Lives list > GET /api/v1/lives — list publicly visible circle livestreams with their state, viewer count, and replay availability, using cursor pagination. > > Source: https://docs.ohmy.xin/en/open-platform/lives/ `GET /api/v1/lives` returns the **publicly visible** livestreams on the platform — scheduled, on air, interrupted, and ended streams (with their replays). ## Contract at a glance | Item | Value | | --- | --- | | Method and path | `GET /api/v1/lives` | | Full URL | `https://ohmy.xin/api/v1/lives` | | Authentication | Bearer key required | | Request body | None | | Response | `data` is an array of live objects, `meta.pagination` carries the page info | | Pagination | Cursor based, 20 items per page by default, 100 maximum | | Visibility | Only directory-listed streams in public circles are returned | ## Request ```http GET /api/v1/lives HTTP/1.1 Host: ohmy.xin Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy... Accept: application/json ``` Authentication, rate limiting, and the error envelope follow the shared [API conventions](/en/open-platform/api-reference); this page covers only what is specific to the endpoint. ## Query parameters Every parameter is optional. Calling the endpoint with no parameters returns the first page in the default sort order. | Parameter | Type | Default | Description | | --- | --- | --- | --- | | `limit` | integer | `20` | Items per page, between `1` and `100`. Out-of-range values return `400`. | | `cursor` | string | — | The `meta.pagination.next_cursor` from the previous page. An opaque string — send it back verbatim. | | `sort` | string | `created_at:desc` | Sort order: `created_at:desc` (newest first by creation time) or `updated_at:desc` (newest first by update time). | | `circle_number` | string | — | Filter by circle, using the circle's `number` (up to 32 characters). | | `state` | string | `scheduled,live,interrupted` | Filter by state, comma-separated. Allowed values: `scheduled`, `live`, `interrupted`, `ended`. | | `scheduled_after` | ISO 8601 timestamp | — | Lower bound on `scheduled_at` (inclusive). | | `scheduled_before` | ISO 8601 timestamp | — | Upper bound on `scheduled_at` (inclusive). | | `updated_after` | ISO 8601 timestamp | — | Lower bound on `updated_at` (inclusive). | > **The cursor is bound to the sort order** > The cursor encodes the `sort` used for the previous page. Switching `sort` invalidates an old cursor and returns `400 invalid_parameter` — request the first page again without `cursor`. > > **Time windows must be ordered** > `scheduled_after` must be earlier than or equal to `scheduled_before`, otherwise the call returns `400 invalid_parameter`. > ### Example request ```bash curl -s "https://ohmy.xin/api/v1/lives?limit=2&state=scheduled,live&circle_number=7000101526" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` ## Response ### `data[]` fields `data` is an array; each element describes one livestream. | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `number` | string | No | The stream's public number. **The internal `id` is never returned.** | | `title` | string | No | Stream title. | | `description` | string | Yes | Stream description; `null` when there is none. | | `kind` | string | No | Stream kind — always `video` today. | | `state` | string | No | State: `scheduled`, `live`, `interrupted`, or `ended`. | | `url` | string | No | The room URL — share it directly with users. | | `cover_url` | string | Yes | Cover image URL; `null` when there is none. | | `viewer_count` | integer | Yes | Current viewers. **Only populated while the stream is on air** (`live` / `interrupted`); `null` in every other state. | | `scheduled_at` | ISO 8601 timestamp | Yes | Scheduled start time. | | `started_at` | ISO 8601 timestamp | Yes | Actual start time. | | `ended_at` | ISO 8601 timestamp | Yes | End time. | | `duration_seconds` | integer | No | Stream duration in seconds; `0` before it starts or before it ends. | | `replay_available` | boolean | No | Whether a replay is available: `true` once the stream has ended, the replay is visible, and a recording is ready. | | `comments_count` | integer | No | Number of comments. | | `reminders_count` | integer | No | Number of reminders. | | `updated_at` | ISO 8601 timestamp | No | Last update time. | | `circle` | object | No | The circle that owns the stream. | | `host` | object | Yes | The host; `null` when unavailable. | > **The viewer count is not a stable counter** > `viewer_count` comes from the platform's live presence tracking and is only populated while a stream is on air. It can read `null` before a stream starts, after it ends, and around state transitions. If you need a stable number, keep your own samples. > ### `circle` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `number` | string | No | Circle number — feed it straight into the `circle_number` filter. | | `name` | string | No | Circle name. | | `url` | string | No | Circle home page, in the live channel view. | | `avatar_url` | string | Yes | Circle avatar URL. | ### `host` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `name` | string | No | Host display name. | | `avatar_url` | string | Yes | Host avatar URL. | ### `meta.pagination` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `limit` | integer | No | The page size actually applied. | | `has_more` | boolean | No | Whether another page exists. | | `next_cursor` | string | Yes | Cursor for the next page; `null` when `has_more` is `false`. | ### Example response ```json { "data": [ { "number": "9100004", "title": "On air now", "description": "Weekly market outlook", "kind": "video", "state": "live", "url": "https://ohmy.xin/circles/7000101526/lives/9100004", "cover_url": "https://ohmy.xin/circles/7000101526/lives/9100004/card_cover.png?v=1a2b3c4d", "viewer_count": 42, "scheduled_at": null, "started_at": "2024-01-16T10:00:00+08:00", "ended_at": null, "duration_seconds": 0, "replay_available": false, "comments_count": 12, "reminders_count": 7, "updated_at": "2024-01-16T10:30:00+08:00", "circle": { "number": "7000101526", "name": "Crypto Lab", "url": "https://ohmy.xin/circles/7000101526?channel=live", "avatar_url": "https://cdn.ohmy.xin/circles/7000101526/avatar.webp" }, "host": { "name": "Alice", "avatar_url": "https://cdn.ohmy.xin/users/a1b2c3/avatar.webp" } } ], "meta": { "pagination": { "limit": 20, "has_more": false, "next_cursor": null }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## Pagination Pagination is cursor based: fetch the first page, take `meta.pagination.next_cursor`, pass it back as the `cursor` parameter on the next call, and stop when `has_more` is `false`. ```bash # First page curl -s "https://ohmy.xin/api/v1/lives?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." # Next page — pass the previous next_cursor back verbatim curl -s "https://ohmy.xin/api/v1/lives?limit=2&cursor=eyJzIjoidHJlYXRlZF9hdDpkZXNjIiwiYyI6WyIyMDI0LTAxLTE2VDAyOjAwOjAwWiIsOTEwMDAwNF19" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` > **Never assemble a cursor yourself** > The cursor is an opaque string issued by the platform; it encodes the sort order and the cursor position. Hand-building, editing, or reusing one across endpoints returns `400 invalid_parameter`. The same cursor can be replayed safely for a repeated request. > ## Visibility rules A livestream appears in the list only when **all** of these hold: 1. The host has listed it in the circle's livestream directory (`directory_listed` is true); 2. Its state is `scheduled`, `live`, `interrupted`, or `ended`; 3. Its circle is bound to Mixin, not dormant, and set to public. > **Lives and strategies gate circles differently** > The strategies endpoint only includes circles that are **free or in teaser mode**, while the lives endpoint only requires the circle to be **public** — so **lives from paid circles do appear in the public API**. The two endpoints do not cover the same set of circles; judge visibility per endpoint. > > **An empty list may mean the feature is not rolled out** > When livestreaming is not open to everyone, or the streaming provider is not fully configured, this endpoint returns `200` with an **empty array** (`data: []`, `has_more: false`) rather than an error. Use that to tell "no streams right now" apart from "livestreaming is not available yet". > > **The endpoint exposes no internal fields** > The response contains only fields meant for public visitors. The internal live `id`, internal circle and host IDs, the ingest stream name (`stream_name`), the ingest credential expiry (`ingest_expires_at`), provider metadata, the audience statistics (`unique_viewers`, `peak_viewers`, `members_joined`), and the host's Mixin UUID are never included. > ## Errors Beyond the shared envelope, this endpoint adds one case: | HTTP status | `error.code` | When it happens | | --- | --- | --- | | `400` | `invalid_parameter` | A query parameter is invalid: `limit` out of range, an illegal `sort`/`state` value, a malformed timestamp, an inverted time window, or an invalid cursor. | The `400` response lists each offending parameter in `error.details`: ```json { "error": { "code": "invalid_parameter", "message": "Invalid query parameter: state must contain only: scheduled, live, interrupted, ended.", "details": [ { "param": "state", "reason": "must contain only: scheduled, live, interrupted, ended" } ] }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` For the other status codes (`401`, `429`, `503`, `500`), see the [API conventions](/en/open-platform/api-reference#error-codes). ## Related pages - [API reference](/en/open-platform/api-reference) — authentication, rate limits, response envelope, and error codes - [Quickstart](/en/open-platform/getting-started) — create an account, generate a key, make your first call - [Strategies list](/en/open-platform/strategies) — the other list endpoint - [OpenAPI spec](/openapi.json) — the machine-readable description of this endpoint (OpenAPI 3.1) --- #### Open platform > Connect your own systems to OhMy.xin over the API — accounts, keys, rate limits, and call logs handled by the platform. > > Source: https://docs.ohmy.xin/en/open-platform/ The OhMy.xin open platform exposes part of the platform to external systems over an API: you create an **API account** and **API keys** on the website, then call the open endpoints from your own software. Auth, rate limiting, the shared response and error format, call logging — the platform handles all of that, so you can focus on your own integration. ## What is open today The shared integration framework ships with two service endpoints: - **Health check** (`GET /api/v1/health`) — no key needed; confirms the service is reachable. - **Credential self-check** (`GET /api/v1/me`) — call it with your key to confirm the credential works and see your account and key details. Two business endpoints are already live on top of it: - **Strategies list** (`GET /api/v1/strategies`) — publicly visible trading signals, filterable by circle, symbol, side, and time window. - **Lives list** (`GET /api/v1/lives`) — publicly visible livestreams with their state, viewer count, and replay availability. More business endpoints will be added to the same framework over time. They inherit the same auth, rate limiting, pagination, and error contract automatically — your integration code needs no extra adaptation for them. > **Who can use the open platform** > Any signed-in OhMy.xin user in good standing can self-serve API accounts and keys — no application or approval needed. Platform admins can freeze misbehaving accounts. > ## Core concepts | Concept | What it means | | --- | --- | | API account | The unit you integrate under; use separate accounts to isolate projects or environments (say, one for production, one for testing). Up to 5 per user by default. | | API key | The credential you call the API with, attached to an API account and prefixed with `omx_live_`. The full secret is shown exactly once, at creation; afterwards only a masked fragment. Up to 10 active keys per account by default. | | Rate limit | 60 requests per minute per API account by default; a fallback per-IP bucket (default 300 per minute) additionally caps all `/api/` traffic from one source IP, valid credentials or not. | | Call log | Every request that enters the gateway's processing chain — auth failures and throttled calls included — leaves a structured record you can filter by key, time, endpoint, and outcome. Kept for 90 days by default; requests rejected outright by the IP-level bucket leave no record. | | Request ID | Every response carries a unique `request_id`; share it with the platform and support can line up the server logs. | > **Key safety** > The full key is shown once, at the moment of creation; the platform stores only a one-way digest. Treat it like a password: never commit it to a public repository, and revoke it immediately if it leaks. > ## Start here - [Quickstart](/en/open-platform/getting-started) — Create an API account, generate a key, and make your first call in about five minutes. - [API reference](/en/open-platform/api-reference) — Base URL, authentication, response and error envelopes, pagination, rate limits, and the error-code table. - [Strategies list](/en/open-platform/strategies) — GET /api/v1/strategies — publicly visible trading signals, with filters and a full field reference. - [Lives list](/en/open-platform/lives) — GET /api/v1/lives — publicly visible livestreams, viewer counts, and replay availability. ## Machine-readable The same contract is available in machine-readable form, so code generators and LLM tool-calls can consume it directly: - [OpenAPI 3.1 spec](/openapi.json) — every endpoint, parameter, and response schema - [llms.txt](/llms.txt) — the page index - [llms-full.txt](/llms-full.txt) — the full text of every page --- #### Quickstart > Create an API account, generate a key, and make your first call in about five minutes. > > Source: https://docs.ohmy.xin/en/open-platform/getting-started/ This page takes you from zero to your first API call: create an API account, generate a key, and call an endpoint with it. Everything happens on the website plus one terminal — about five minutes end to end. ## Before you begin - An OhMy.xin account you can sign in with (signing in with Mixin is enough). - A terminal or tool that can send HTTP requests — the examples below use `curl` and can be copied as-is. ## 1. Open the developer API page Sign in to OhMy.xin on the web, click your **avatar** in the top-right corner to open the menu, and choose **Developer API**. ## 2. Create an API account Click **New API account**, fill in a name (required) and an optional description, and submit. You land on the account page, which shows the account number, its state, and the current rate limit. Use API accounts to isolate integrations or environments — one for production, one for testing, for example. The default ceiling is 5 accounts per user, counted across all of your accounts including disabled ones. Retire an account you no longer need by **disabling** it on its page — disabling turns off its keys but does not free up a slot. ## 3. Generate an API key On the account page, find **API keys**, click **Generate key**, and give it a name (say, "Primary key"). > **The full key is shown only once** > Right after creation the page shows the complete key, which looks like `omx_live_xxxxxxxx_yyyyyyyy…`. **Once you close or refresh the page it is gone for good.** Copy it somewhere safe immediately. If you lose it, your only option is to generate a new key and revoke the old one. > From then on the key list shows only the name, prefix, and a masked tail — never the full secret again. Each account allows up to 10 active keys by default, on purpose: it lets you run an old and a new key side by side and rotate without downtime (see below). ## 4. Make your first call Start with the health check, which needs no key: ```bash curl -s https://ohmy.xin/api/v1/health ``` Then the credential self-check with your key (replace `omx_live_…` with the full key you saved): ```bash curl -s https://ohmy.xin/api/v1/me \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` A successful call returns JSON in the shared envelope with your account and key details: ```json { "data": { "account": { "number": "8392014", "name": "Production Integration", "state": "active", "rate_limit_per_minute": 60 }, "key": { "name": "Primary Key", "masked_token": "omx_live_a1b2c3d4••••••••x9y0", "state": "active", "last_used_at": "2026-11-15T22:14:12+08:00" } }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## 5. Fetch a real list The two built-in endpoints confirm the plumbing. To pull actual data, call one of the business endpoints — they share the same auth, rate limiting, and pagination: ```bash curl -s "https://ohmy.xin/api/v1/strategies?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` ```bash curl -s "https://ohmy.xin/api/v1/lives?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` Both return `data` as an array plus a `meta.pagination` block. When `meta.pagination.has_more` is `true`, pass `meta.pagination.next_cursor` back as the `cursor` parameter to fetch the next page. See the [strategies reference](/en/open-platform/strategies) and the [lives reference](/en/open-platform/lives) for every filter and field. ## 6. Check the call log Back on the **Developer API** page, open the account and scroll to **Recent calls**: every request is listed with its time, endpoint, status code, outcome, duration, and source IP, filterable by key, time range, endpoint, and outcome, with success/failure totals at the top. Records are collected asynchronously, so they appear shortly after the request itself; requests rejected outright by the IP-level bucket never make it into the log. Details are kept for 90 days by default. ## Rotate keys without downtime Keys are built for no-downtime rotation: 1. **Generate a new key** under the same account; 2. Swap the key in your integration and confirm calls succeed; 3. **Revoke** the old key — its very next request is rejected. If a key leaks, don't wait for a rotation window: **disable** it (re-enable later if needed) or **revoke** it (permanent) — the change takes effect immediately. ## If something goes wrong | Symptom | Cause and fix | | --- | --- | | `401 unauthorized` | Credentials missing, the key copied incompletely or wrongly, the key disabled/revoked, or its account disabled/frozen. For safety reasons the platform does not say which — first check that the key was copied in full and its state is "active". | | `429 rate_limit_exceeded` | Rate limit hit. The `Retry-After` response header says how long to wait; accounts default to 60 requests per minute. | | `404 not_found` | Unknown endpoint. The open endpoints are `/api/v1/health`, `/api/v1/me`, `/api/v1/strategies`, and `/api/v1/lives` — see the [API reference](/en/open-platform/api-reference). | | `400 invalid_parameter` | A query parameter is invalid. `error.details` names the offending parameter; see the endpoint page for the accepted values. | | No `X-RateLimit-*` headers | Two possibilities: the `Authorization` header is malformed (auth never succeeded), or the request was rejected by the IP-level fallback bucket — the latter's message is "Too many requests. Please retry later.". Tell them apart by the response message. | ## Related pages - [API reference](/en/open-platform/api-reference) - [Strategies list](/en/open-platform/strategies) - [Lives list](/en/open-platform/lives) - [Open platform overview](/en/open-platform/) --- #### Strategies list > GET /api/v1/strategies — list publicly visible trading signals, filtered by circle, symbol, side, and time window, with cursor pagination. > > Source: https://docs.ohmy.xin/en/open-platform/strategies/ `GET /api/v1/strategies` returns the **publicly visible** trading signals on the platform. You get the content of the signal card itself — symbol, side, entry price, target price, stop price, take-profit ladder — plus the display details of the owning circle and the publisher. ## Contract at a glance | Item | Value | | --- | --- | | Method and path | `GET /api/v1/strategies` | | Full URL | `https://ohmy.xin/api/v1/strategies` | | Authentication | Bearer key required | | Request body | None | | Response | `data` is an array of strategy objects, `meta.pagination` carries the page info | | Pagination | Cursor based, 20 items per page by default, 100 maximum | | Visibility | Only signals visible to public visitors are returned | ## Request ```http GET /api/v1/strategies HTTP/1.1 Host: ohmy.xin Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy... Accept: application/json ``` Authentication, rate limiting, and the error envelope follow the shared [API conventions](/en/open-platform/api-reference); this page covers only what is specific to the endpoint. ## Query parameters Every parameter is optional. Calling the endpoint with no parameters returns the first page in the default sort order. | Parameter | Type | Default | Description | | --- | --- | --- | --- | | `limit` | integer | `20` | Items per page, between `1` and `100`. Out-of-range values return `400`. | | `cursor` | string | — | The `meta.pagination.next_cursor` from the previous page. An opaque string — send it back verbatim. | | `sort` | string | `published_at:desc` | Sort order: `published_at:desc` (newest first by publish time) or `updated_at:desc` (newest first by update time). | | `circle_number` | string | — | Filter by circle, using the circle's `number` (up to 32 characters). | | `symbol` | string | — | Filter by trading symbol, **case-insensitive** (up to 32 characters) — `BTC` and `btc` are equivalent. | | `side` | string | — | Filter by direction: `long` or `short`. | | `state` | string | `running,take_profit,stop_loss` | Filter by state, comma-separated. Allowed values: `running`, `take_profit`, `stop_loss`. | | `published_after` | ISO 8601 timestamp | — | Lower bound on `published_at` (inclusive). | | `published_before` | ISO 8601 timestamp | — | Upper bound on `published_at` (inclusive). | | `updated_after` | ISO 8601 timestamp | — | Lower bound on `updated_at` (inclusive). | > **The cursor is bound to the sort order** > The cursor encodes the `sort` used for the previous page. Switching `sort` invalidates an old cursor and returns `400 invalid_parameter` — request the first page again without `cursor`. > > **Time windows must be ordered** > `published_after` must be earlier than or equal to `published_before`, otherwise the call returns `400 invalid_parameter`. The same rule applies to `scheduled_after` / `scheduled_before` on the lives endpoint. > ### Example request ```bash curl -s "https://ohmy.xin/api/v1/strategies?limit=2&symbol=BTC&side=long&state=running" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` ## Response ### `data[]` fields `data` is an array; each element describes one strategy. | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `id` | integer | No | The signal's record ID — useful for long-term de-duplication and idempotent handling. | | `symbol` | string | No | Trading symbol, returned exactly as the author entered it — the platform does not normalize its case. Match it case-insensitively. | | `side` | string | No | Direction: `long` or `short`. | | `state` | string | No | State: `running`, `take_profit`, or `stop_loss`. | | `entry_price` | string | No | Entry price. | | `target_price` | string | No | Target price. | | `stop_price` | string | No | Stop-loss price. | | `exit_price` | string | Yes | Actual exit price; `null` while the signal is still open. | | `target_stages` | array | No | The take-profit ladder — one entry per level with its target price and whether it was reached. | | `note` | string | Yes | Note attached by the publisher; `null` when there is none. | | `source_name` | string | Yes | Display name of the signal source; `null` when there is none. | | `external_url` | string | Yes | Link to the original signal; `null` when there is none. | | `published_at` | ISO 8601 timestamp | No | Publish time. | | `closed_at` | ISO 8601 timestamp | Yes | Close time; `null` while the signal is still running. | | `updated_at` | ISO 8601 timestamp | No | Last update time. | | `circle` | object | No | The circle that owns the signal. | | `author` | object | Yes | The member who published it; `null` when unavailable. | Every price field is a **string**, not a number — trailing zeros are stripped (`65000.00` comes back as `"65000"`). Convert before doing arithmetic to avoid floating-point drift. ### `target_stages[]` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `level` | integer | No | Position in the ladder, counting from `1`. | | `price` | string | No | Target price for this level. | | `reached_at` | ISO 8601 timestamp | Yes | When the level was reached; `null` when it has not been. | | `reached_price` | string | Yes | The actual price when the level was reached; `null` when it has not been. | ### `circle` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `number` | string | No | Circle number — feed it straight into the `circle_number` filter. | | `name` | string | No | Circle name. | | `url` | string | No | Circle home page, in the strategy channel view. | | `avatar_url` | string | Yes | Circle avatar URL. | ### `author` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `name` | string | No | Display name of the publisher. | | `avatar_url` | string | Yes | Avatar URL of the publisher. | ### `meta.pagination` fields | Field | Type | Nullable | Description | | --- | --- | --- | --- | | `limit` | integer | No | The page size actually applied. | | `has_more` | boolean | No | Whether another page exists. | | `next_cursor` | string | Yes | Cursor for the next page; `null` when `has_more` is `false`. | ### Example response ```json { "data": [ { "id": 4821, "symbol": "BTC", "side": "long", "state": "running", "entry_price": "65000", "target_price": "70000", "stop_price": "62000", "exit_price": null, "target_stages": [ { "level": 1, "price": "67000", "reached_at": "2024-01-15T04:00:00+08:00", "reached_price": "67050.5" }, { "level": 2, "price": "68500", "reached_at": null, "reached_price": null } ], "note": "Daily breakout; hold while the retest holds.", "source_name": "BTC Trend Tracker", "external_url": "https://example.com/signals/btc-4821", "published_at": "2024-01-15T10:00:00+08:00", "closed_at": null, "updated_at": "2024-01-16T09:30:00+08:00", "circle": { "number": "7000101526", "name": "Crypto Lab", "url": "https://ohmy.xin/circles/7000101526?channel=strategy", "avatar_url": "https://cdn.ohmy.xin/circles/7000101526/avatar.webp" }, "author": { "name": "Alice", "avatar_url": "https://cdn.ohmy.xin/users/a1b2c3/avatar.webp" } } ], "meta": { "pagination": { "limit": 20, "has_more": true, "next_cursor": "eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19" }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## Pagination Pagination is cursor based: fetch the first page, take `meta.pagination.next_cursor`, pass it back as the `cursor` parameter on the next call, and stop when `has_more` is `false`. ```bash # First page curl -s "https://ohmy.xin/api/v1/strategies?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." # Next page — pass the previous next_cursor back verbatim curl -s "https://ohmy.xin/api/v1/strategies?limit=2&cursor=eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` > **Never assemble a cursor yourself** > The cursor is an opaque string issued by the platform; it encodes the sort order and the cursor position. Hand-building, editing, or reusing one across endpoints returns `400 invalid_parameter`. The same cursor can be replayed safely for a repeated request. > ## Visibility rules A strategy appears in the list only when **all** of these hold: 1. Its state is `running`, `take_profit`, or `stop_loss`; 2. It has been published (`published_at` is set); 3. It carries no member-tier gate, and its audience is public (`everyone`); 4. Its circle is bound to Mixin, not dormant, set to public, and **either free or browsable in teaser mode**. Condition 4 means: **strategies from circles that are paid and closed to browsing never appear in the public API**. If a circle number returns nothing, check that first. > **The endpoint exposes no internal fields** > The response contains only fields meant for public visitors. Internal circle IDs, the publisher's Mixin UUID, tier gates, and the raw signal payload are never included — and should not be relied on even if you could infer them. > ## Errors Beyond the shared envelope, this endpoint adds one case: | HTTP status | `error.code` | When it happens | | --- | --- | --- | | `400` | `invalid_parameter` | A query parameter is invalid: `limit` out of range, an illegal `sort`/`state`/`side` value, a malformed timestamp, an inverted time window, or an invalid cursor. | The `400` response lists each offending parameter in `error.details`: ```json { "error": { "code": "invalid_parameter", "message": "Invalid query parameter: limit must be an integer between 1 and 100.", "details": [ { "param": "limit", "reason": "must be an integer between 1 and 100" } ] }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` For the other status codes (`401`, `429`, `503`, `500`), see the [API conventions](/en/open-platform/api-reference#error-codes). ## Related pages - [API reference](/en/open-platform/api-reference) — authentication, rate limits, response envelope, and error codes - [Quickstart](/en/open-platform/getting-started) — create an account, generate a key, make your first call - [Lives list](/en/open-platform/lives) — the other list endpoint - [OpenAPI spec](/openapi.json) — the machine-readable description of this endpoint (OpenAPI 3.1) ### Overview / 概览 #### OhMy.xin User Guide > Join or create a circle on Mixin Messenger from zero — step-by-step guides, FAQ, and troubleshooting. > > Source: https://docs.ohmy.xin/en/ - [What is OhMy.xin?](/en/start-here/what-is-ohmyxin) — The platform in one page, and why it lives inside Mixin Messenger. - [What is Mixin Messenger?](/en/mixin-basics/what-is-mixin) — The app where circles live: chat plus a built-in wallet. - [Join a circle](/en/start-here/join-a-circle) — From an invite link to your first message in about ten minutes. - [Create your own circle](/en/start-here/create-a-circle) — Create a Mixin bot, connect it, and launch a paid community. - [FAQ](/en/reference/faq) — Answers to the questions new users ask most. - [Pricing & fees](/en/reference/pricing-and-fees) — Platform service fees, Circle VIP prices, and settlement rules. - [Glossary](/en/reference/glossary) — Every term in this guide, Chinese and English side by side. - [Open platform](/en/open-platform/) — Create API accounts and keys to connect your own systems to OhMy.xin. --- #### What's new > Important platform features and fixes, newest first. > > Source: https://docs.ohmy.xin/en/whats-new/ ## Open platform: strategies and lives are now public API endpoints Two business endpoints are live under `/api/v1`, alongside the existing health check and credential self-check. `GET /api/v1/strategies` lists publicly visible trading signals with their symbol, side, entry/target/stop prices, and take-profit ladder — filterable by circle, symbol, side, state, and publish-time window. `GET /api/v1/lives` lists publicly visible livestreams with their state, viewer count, and replay availability — filterable by circle, state, and scheduled-time window. Both use cursor pagination, return the same response envelope, and inherit the same auth, rate limiting, and error contract as the rest of the platform. The full contract is documented per endpoint, and as a machine-readable OpenAPI 3.1 spec. ## Open platform: self-serve API accounts and keys The platform now exposes a unified external API. Any signed-in user can create API accounts and generate keys from the avatar menu → Developer API, then call the open endpoints under `/api/v1` (a health check and a credential self-check; business endpoints mount on the same framework). Auth, per-minute rate limits, and call logs are handled by the platform; the full key is shown exactly once at creation, keys rotate without downtime, and disabling or revoking takes effect immediately. ## Member tiers: free entry with paid Pro content A circle can now sell a Pro content layer on top of entry: members join as usual, then buy a tier separately. Set it up in Console → Money → Member tiers with a name, description, price, currency, and duration, then pick an audience when you publish a post, write an article, create a strategy, or answer a question. Members without the tier see a teaser and an unlock card; buying a tier only unlocks content — it never changes a role, circle membership, or an expiry date. ## Oh My Live: immersive rooms, network-aware playback lines, mode-aware chat The live room is now a full-bleed stage: chat and the composer float over the video on phones and dock to a side column on desktop, and off-air states hide the viewer count and composer. Playback picks a line from the viewer's network (overseas LEB → FLV → HLS, mainland FLV → HLS), offers a picker when it cannot detect one, and remembers the choice. The /live home and the circle strip follow: on air now, starting soon, and replays at a glance. ## Strategies console splits into tabs, signal import moves to the circle owner The strategies console now has three tabs: strategy list, disclaimer, and signal import. The platform only decides which circle may receive which signal source; the circle owner decides whether to import, draft versus auto-publish, the plan and analyst filters, and the strategy author (import is off by default). ## Hiding the member count also hides the member list With "Hide member count" on, members and visitors no longer see the number, and the member list leaves only the admin team; the owner and admins still see everything. ## Home entries management joins the layout customize sheet For Story Hub and Trading Hub, home entries are now managed in the customize sheet's Home entries tab: the full list, new-entry button, and inline editing and deletion all happen inside the sheet, matching the showcase pages and cards tabs. Community Hub has no customize sheet and keeps its page under Content. ## Trading Hub strategies move to the member site Trading Hub owners and admins can now create and maintain strategies right from the member home page: publishing goes live immediately and notifies subscribers, and each card's menu offers edit, take-profit, stop-loss, cancel, and delete based on its state. ## Console Appearance redesign: layout rail and customize sheet Settings → Appearance is now a horizontal layout rail that spells out what a switch gains and loses before saving; each layout's "Layout customize" opens a side sheet, and Trading Hub showcase pages and cards are managed inline in that sheet. ## 简体中文 ### Start here / 快速开始 #### 什么是 OhMy.xin? > 一个运行在 Mixin Messenger 里的圈子社区平台 —— 看帖、聊天、付费会员、打赏与活动。 > > Source: https://docs.ohmy.xin/start-here/what-is-ohmyxin/ OhMy.xin 是一个运行在 [Mixin Messenger](/mixin-basics/what-is-mixin) 里的社区平台。我们把这些社区叫作 **圈子**:一个由机器人承载、有帖子有聊天有会员体系的线上空间。 一个圈子里通常有: - **帖子与文章** —— 圈主发布的图文内容,部分内容仅限会员。 - **聊天** —— 取决于圈子设置,你可以提问、讨论,或只收听圈主的广播。 - **会员身份** —— 付费或免费加入,决定你能看到什么、做到什么。 - **打赏、红包、抽奖** —— 用 Mixin 钱包里的资产参与的互动。 ## 我需要懂加密货币吗? 不需要。你只需要 Mixin Messenger:注册和聊天与普通聊天应用一样。只有在付费加入圈子或参与打赏时才会用到钱包,我们会在那一步解释具体操作。 ## 这安全吗? - 登录通过 Mixin 账号完成,OhMy.xin 不接触你的钱包私钥。 - 圈主的收入不经平台留存 —— 每笔订单完成后,平台立即通过 Mixin 安全转账把圈主份额直接转到圈主自己的 Mixin 钱包。 - 对任何索要密钥文件、助记词的行为保持警惕 —— 官方永远不会索要这些。 ## 相关页面 - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) - [加入一个圈子](/start-here/join-a-circle) - [创建自己的圈子](/start-here/create-a-circle) --- #### 创建自己的圈子 > 从创建 Mixin 机器人到完成接入向导,开启你的付费社区。 > > Source: https://docs.ohmy.xin/start-here/create-a-circle/ 读完本页,你将拥有一个运行在 OhMy.xin 上的圈子,并完成基础设置。 ## 开始之前 - 一个 Mixin 账号,以及一台电脑(要下载并上传一个文件)。 - 约 30 分钟。 - 一个存放机器人密钥文件的安全位置 —— 它相当于机器人的钥匙,不要分享给任何人。 ## 第一部分:注册机器人并接入(约 10 分钟) 这是整个过程中最需要细心的一步:在 Mixin 上拿到 **两样东西**,再交给 OhMy.xin。先在下面点一遍,再照着做。 想了解这两样东西分别是什么、出错了怎么办,看 [在 Mixin 创建机器人](/creator-guide/create-your-bot) 和 [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin)。 ## 第二部分:开张 1. 跟随 [上线清单](/creator-guide/launch-checklist) 完成基础设置:欢迎语、圈子简介、聊天模式。 2. 设置会员套餐与定价,然后分享邀请链接,迎接第一位成员。 ## 接下来会发生什么 - 成员付费后,平台立即把扣除 10% 服务费与邀请奖励后的收入直接转入你的 Mixin 钱包,通常几秒到几分钟到账。 - 在控制台的 **今日** 页可以随时查看运营状态。 ## 如果出了问题 - **密钥上传后校验失败** —— 确认 keystore 和 Client Secret 来自同一个机器人,且都是最新生成的;更多情况见 [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin#如果出了问题)。 - **机器人无法接入** —— 一个机器人只能接入一个圈子;如果它曾被其他圈子使用,先在原圈子断开连接。 ## 相关页面 - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) - [创作者指南](/creator-guide/) - [常见问题](/reference/faq) --- #### 加入一个圈子 > 从一条邀请链接到发出第一条消息 —— 完整的加入步骤。 > > Source: https://docs.ohmy.xin/start-here/join-a-circle/ 读完本页,你将完成从收到邀请链接到在圈子里发出第一条消息的全部操作。 ## 开始之前 - 一部装有 [Mixin Messenger](/mixin-basics/what-is-mixin) 的手机,并已完成注册。 - 一条圈子邀请链接,通常由群聊或好友分享。 - 如果是付费圈子:Mixin 钱包里有圈子接受的资产(如 USDT)。 ## 步骤 在下面的手机上点一遍 —— 每一步都是你实际会看到的界面。 ## 接下来会发生什么 - 会员到期前圈子会提醒你续费;部分圈子为续费提供折扣,以续费页显示的价格为准。 - 在 **我的** 页可以随时查看会员状态与转账记录。 ## 如果出了问题 - **支付后会员没有生效** —— 等几秒后刷新;仍未生效时用支付编号在订单页查询,或联系圈子管理员。 - **提示“请升级 Mixin Messenger”** —— 收取红包、打赏等转账需要较新版本,去应用商店升级即可。 - **邀请链接打不开** —— 确认手机已安装 Mixin Messenger;没有的话先 [下载安装](/mixin-basics/what-is-mixin)。 ## 相关页面 - [什么是 OhMy.xin?](/start-here/what-is-ohmyxin) - [会员指南](/member-guide/) - [常见问题](/reference/faq) --- #### 新手?选择你的路径 > 想加入圈子,还是想创建自己的圈子?两条路径的花费与准备都在这里。 > > Source: https://docs.ohmy.xin/start-here/pick-your-path/ OhMy.xin 上有两种人:**加入圈子的人**和**创建圈子的人**。回答两三个问题,直接跳到你该看的那一页。 想先看看两条路各要花多少时间和钱?往下读。 ## 我想加入圈子 适合想在圈子里看内容、聊天、参与互动的你。 - **要准备什么** —— 一部手机,装好 [Mixin Messenger](/mixin-basics/what-is-mixin)。 - **要花多少钱** —— 免费圈子一分钱不用花;付费圈子按圈主定的套餐收费,通常按月或按年,用 Mixin 钱包里的资产支付。 - **要多久** —— 从邀请链接到发出第一条消息,大约十分钟。 → 走 [加入一个圈子](/start-here/join-a-circle) 这条路径。 ## 我想创建圈子 适合有内容或社群、想经营自己的付费社区的你。 - **要准备什么** —— 一个 Mixin 账号,约 30 分钟完成创建与接入。 - **要花多少钱** —— 创建与运行圈子本身免费;每笔会员或成员档位订单平台收取 10% 服务费。可选的 [圈子 VIP](/reference/pricing-and-fees) 按月付费(支持 1/3/12 个月预付),解锁高级布局等功能。 - **要多久** —— 当天即可上线,迎接第一位付费成员。 → 走 [创建自己的圈子](/start-here/create-a-circle) 这条路径。 ## 还在犹豫? 先读 [什么是 OhMy.xin?](/start-here/what-is-ohmyxin),或查看 [定价与费用一览](/reference/pricing-and-fees) 了解具体数字。 ### Mixin basics / Mixin 基础 #### 什么是 Mixin Messenger? > 圈子生活的地方 —— 一款聊天加钱包的手机应用。 > > Source: https://docs.ohmy.xin/mixin-basics/what-is-mixin/ Mixin Messenger 是一款手机聊天应用([messenger.mixin.one](https://messenger.mixin.one/) 下载,支持 iOS 与 Android)。它看起来和普通聊天应用差不多,但内置了钱包功能。 OhMy.xin 的圈子运行在 Mixin 里,因为: - **登录即身份** —— 用 Mixin 账号一键登录,无需注册新账号、无需密码。 - **支付即转账** —— 会员费、打赏、红包都是 Mixin 钱包里的转账,通常几秒内到账。 - **圈子即对话** —— 每个圈子由一个 Mixin 机器人承载,点开机器人头像就能浏览帖子和回放。 ## 三个你会遇到的概念 - **** —— 你的用户标识,别人可以通过它找到你。 - **钱包** —— 存放 USDT、BTC 等资产的地方,付款时从这里扣。 - **安全转账(Safe)** —— 圈子的收款与打赏都通过 Mixin 的安全转账机制完成,通常几秒到几分钟到账。 ## 相关页面 - [什么是 OhMy.xin?](/start-here/what-is-ohmyxin) - [术语表](/reference/glossary) --- #### 你的 Mixin 账号与 Mixin ID > 手机号、Mixin ID 各是什么,别人怎么找到你。 > > Source: https://docs.ohmy.xin/mixin-basics/your-mixin-account/ 用手机号注册,就得到了一个 Mixin 账号 —— 它是你的登录身份,也是你的钱包入口。 ## 三个标识,各管什么 - **手机号** —— 注册用,别人默认看不到。 - **Mixin ID** —— 你的专属数字编号,在「个人资料」页可以查看。别人通过它搜索并找到你。 - **UUID** —— 一串系统内部使用的随机字符,不需要记住,也不需要分享。 ## 你在 OhMy.xin 里哪里会遇到它 - 登录 OhMy.xin 用的是 Mixin 账号授权,无需另外注册或设置密码。 - 圈子的介绍页展示圈子简介与成员数;加入和付款都通过圈主分享的邀请链接,在圈子机器人里完成。 ## 保护好你的账号 - 不要把验证码、密码或密钥文件给任何人 —— [官方永远不会索要](/mixin-basics/staying-safe)。 - 换手机号前,先在 Mixin 设置里更换绑定。 ## 相关页面 - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) - [在 Mixin 里保持安全](/mixin-basics/staying-safe) - [术语表](/reference/glossary) --- #### 圈主的收入与到账 > 圈主的收入怎么到账 —— 每笔支付完成后自动转入你的 Mixin 钱包,无需提现。 > > Source: https://docs.ohmy.xin/mixin-basics/owner-payouts/ 圈主的收入不经平台留存:每笔会员或成员档位订单完成后,OhMy.xin 会立即把你的份额(订单金额 − 10% 服务费 − 邀请奖励)以 Mixin 安全转账直接转入你的 Mixin 钱包,通常几秒到几分钟到账。打赏、红包等奖励同样直接到达收款人的 Mixin 钱包。 ## 你需要做什么 什么都不用 —— 没有余额、没有提现按钮、也不用配置任何钱包。收入到账后就在你自己的 Mixin 钱包里,和好友转给你的钱一样。 ## 你什么时候会注意到它 - **收到订单结算时** —— 每笔支付完成后自动转账,可在 Mixin 的转账记录里核对。 - **收到红包、打赏或奖品时** —— 这些转账同样由平台发出。如果你的 Mixin Messenger 版本较旧,会提示「请升级 Mixin Messenger」,去应用商店升级后重新打开即可领取。 ## 相关页面 - [定价与费用一览](/reference/pricing-and-fees) - [在 Mixin 里保持安全](/mixin-basics/staying-safe) - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) --- #### 在 Mixin 里保持安全 > 三条原则,避开几乎所有的骗局。 > > Source: https://docs.ohmy.xin/mixin-basics/staying-safe/ Mixin 里的钱是真实资产,所以也要像保管现金一样保管它。好消息是:守住三条原则,几乎可以避开所有骗局。 ## 三条原则 - **永远不分享密钥类信息** —— 密钥文件、助记词、私钥、验证码,任何向你要这些东西的都是骗局,没有例外。 - **官方不会主动找你要东西** —— OhMy.xin 和 Mixin 官方不会私信索要转账、密钥或个人信息。收到此类消息,直接忽略并举报。 - **转账前确认对象** —— 付款只发生在 OhMy.xin 的支付页里发起的流程中;陌生人发来的收款请求不要理会。 ## 圈子场景里的注意事项 - **核实圈子入口** —— 只通过圈子的邀请链接(圈主或成员分享)进入,它会打开圈子自己的机器人;付款只在圈子机器人对话内的支付页完成。 - **「内部消息」「保证收益」都是红旗** —— 尤其在交易类圈子里,承诺收益的都值得警惕。 - **升级提示认准应用商店** —— 收转账需要新版 Mixin Messenger 时,去官方应用商店升级,不要点聊天里的安装包。 ## 练一练:安全还是骗局? 用上面的原则判断五条圈子成员可能收到的消息。 ## 密钥文件特别提醒 创建机器人的圈主会拿到一份密钥文件(keystore),它等于机器人的全部权限。只在上传到 OhMy.xin 接入向导时使用,绝不发给任何人 —— 包括自称官方的人。 ## 相关页面 - [你的 Mixin 账号与 Mixin ID](/mixin-basics/your-mixin-account) - [圈主的收入与到账](/mixin-basics/owner-payouts) - [机器人:圈子如何运作](/mixin-basics/bots) --- #### 在 OhMy.xin 上支付 > 会员费、打赏怎么付 —— 支付页、到账时间与转账记录。 > > Source: https://docs.ohmy.xin/mixin-basics/paying-on-ohmyxin/ 在 OhMy.xin 上付款就是一笔 Mixin 转账:选好内容与金额,确认支付,通常几秒内到账。 ## 支付流程 1. 在支付页选择套餐(或金额)与资产。 2. 点击支付,Mixin Messenger 会打开转账确认页;也可以扫描页面上的二维码支付。 3. 确认后等待几秒,支付状态会自动更新。 4. 支付完成后,订单与转账记录可以在「我的」页查看,凭支付编号随时核对这笔转账。 ## 两个实用提示 - **支付页通常 15 分钟内有效**,超时后重新发起即可,不会扣两次钱。 - **不想用列表里的资产?** 选「使用其他资产支付」,通过 Mixpay 用别的资产付款,汇率按实时牌价折算。 ## 钱付给了谁 会员费的付款通过 Mixin 安全转账先到 OhMy.xin 平台钱包;支付完成后,平台立即把圈主份额(订单金额 − 10% 服务费 − 邀请奖励)以 Mixin 安全转账直接转给圈主,通常几秒到几分钟到账 —— 详见 [定价与费用一览](/reference/pricing-and-fees)。 ## 如果出了问题 - **支付后状态一直没更新** —— 等几秒后刷新;仍未生效时在订单页用支付编号查询,或联系圈子管理员。 - **金额转错或不足** —— 与订单不匹配的付款不会生效,平台核实后会原路退回;如长时间未收到退款,请通过 OhMy.xin 官方渠道反馈并附上支付编号。 ## 相关页面 - [钱包与资产](/mixin-basics/wallet-and-assets) - [购买与续费会员](/member-guide/membership) - [常见问题](/reference/faq) --- #### 机器人:圈子如何运作 > 每个圈子都是一个机器人对话 —— 资料页就是圈子的大门。 > > Source: https://docs.ohmy.xin/mixin-basics/bots/ 每个圈子由一个 Mixin 机器人承载。你和圈子的全部互动 —— 看帖、聊天、加入会员 —— 都发生在这个机器人的对话里。 ## 机器人就是圈子的大门 - 点开机器人的头像,进入它的**资料页**:这里能浏览帖子、回放和公告,也是发起聊天、加入圈子的入口。 - 在对话里,机器人负责把帖子推送给你、处理你的指令(比如发 `/help` 看帮助)。 - 机器人的名字和头像就是圈子的名字和头像,由圈主设置。 ## 加入机器人 ≠ 加入会员 打开聊天只是进了大门。免费圈子可以直接点「免费加入」成为成员;付费圈子需要[购买会员](/member-guide/membership)才能看到带锁的内容。只逛不加入,也能浏览公开内容。 ## 怎么找到圈子 圈子通过**邀请链接**传播 —— 群聊或好友分享一条链接,点开就是机器人资料页。 ## 相关页面 - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) - [加入一个圈子](/start-here/join-a-circle) - [什么是 OhMy.xin?](/start-here/what-is-ohmyxin) --- #### 钱包与资产 > Mixin 钱包是什么、里面有哪些资产、付款时怎么用。 > > Source: https://docs.ohmy.xin/mixin-basics/wallet-and-assets/ Mixin Messenger 内置钱包 —— 存放资产、收付款都在这里,入口在 App 的「钱包」页。 ## 圈子里常见的资产 OhMy.xin 平台支持的资产包括 USDT、PUSD、USDC、BTC、ETH、XIN、DOGE、EOS、BOX。具体每个圈子接受哪些,由圈主选择,支付时会列出来供你挑选。 - 不知道选哪个?**USDT** 是最常用的选择,价格稳定。 - 资产之间可以在 Mixin 钱包里兑换。 ## 钱从哪里来 - 别人转给你,或从交易所提币到 Mixin 钱包。 - 收到的红包、打赏、退款也会进入钱包。 ## 付款时发生什么 付款时,你在支付页确认一笔 Mixin 安全转账,钱先到 OhMy.xin 平台钱包,平台再把对应份额实时转给收款方(如圈主),通常几秒内到账。完整流程见 [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin)。 ## 相关页面 - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) - [定价与费用一览](/reference/pricing-and-fees) ### Member guide / 会员指南 #### 会员指南 > 作为圈子成员需要知道的一切 —— 加入、付费、聊天、互动与账户管理。 > > Source: https://docs.ohmy.xin/member-guide/ 这里收录圈子成员(包括只想先看看的访客)会用到的全部指南。 [Screenshot: 经典布局下的圈子主页。] ## 本节内容 - [加入圈子:免费、付费与试用](/member-guide/joining) - [购买与续费会员](/member-guide/membership) - [圈子主页:四种布局导览](/member-guide/layouts) - [帖子、投票、提问与文章](/member-guide/posts-and-articles) - [在圈子里聊天](/member-guide/chatting) - [观看直播与回放](/member-guide/live) - [打赏帖子与成员](/member-guide/tipping) - [红包、抽奖与问答](/member-guide/luck) - [资讯订阅](/member-guide/story-subscriptions) - [账户:资料、火花与离开圈子](/member-guide/your-account) 不确定从哪开始?先读 [加入一个圈子](/start-here/join-a-circle)。 --- #### 加入圈子:免费、付费与试用 > 访客、关注者、成员、过期成员 —— 圈子身份一览,以及各自的门槛。 > > Source: https://docs.ohmy.xin/member-guide/joining/ 圈子里的身份决定了你能看什么、做什么。本页帮你分清这些身份,以及怎么升级到想要的那一档。 ## 四种身份 - **访客** —— 还没加入,只能看公开内容。 - **关注者** —— 免费关注圈子,可浏览公开帖子与公告,收到圈主的广播。 - **成员** —— 圈子的正式一员:看会员内容、在圈子里聊天、参与红包抽奖等互动。 - **过期成员** —— 会员到期后的状态,续费后立即恢复,资料与记录都在。 ## 免费圈子怎么加入 免费圈子的主页有「免费加入」按钮,点击即成为成员,全程无需付款。 免费进圈不代表所有内容都免费:部分圈子另售成员档位,进圈后可以再按需解锁更深的内容 —— 见 [购买与续费会员](/member-guide/membership)。 ## 付费圈子怎么加入 1. 点开圈子的解锁提示或套餐页,挑选套餐。 2. 按提示完成支付(见 [购买与续费会员](/member-guide/membership))。 3. 几秒内生效,即可浏览全部会员内容。 ## 试用期是什么 部分付费圈子提供**试用期**:在套餐页点击试用按钮即可免费体验若干天,期内可看会员内容。试用期不会自动扣费 —— 到期后会员内容重新上锁,想继续就手动购买套餐。带试用标记的圈子会在套餐页注明试用天数。 ## 如果出了问题 - **付了款但身份还是关注者** —— 等几秒后刷新;仍未生效时在订单页用支付编号查询,或联系圈子管理员。 - **试用期结束内容又上锁了** —— 这是正常行为:试用不会自动扣费,购买套餐即可继续访问。 ## 相关页面 - [购买与续费会员](/member-guide/membership) - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [新手?选择你的路径](/start-here/pick-your-path) --- #### 圈子主页:四种布局导览 > 经典、资讯中心、社区大厅、交易大厅 —— 你的圈子长什么样由圈主决定。 > > Source: https://docs.ohmy.xin/member-guide/layouts/ 圈子主页有四种版式,用哪一种由圈主决定 —— 点一点,看看每种长什么样。 在资讯中心里,你可以关注来源,打造自己的时间线 —— 见 [资讯订阅](/member-guide/story-subscriptions)。在交易大厅里,部分付费内容以邀请码或成员档位解锁。 ## 交易大厅:管理策略 圈主和管理员可以直接在成员端管理策略:主页策略区的「新建策略」按钮打开表单,填写标的、方向(多单 / 空单)、入场 / 目标 / 止损价与备注。发布后立即上线,订阅成员会收到通知;也可以把策略设为需要邀请码解锁,或指定给某个成员档位。 每张策略卡片的菜单按状态变化:进行中的策略可以编辑、止盈、止损、取消或删除;已止盈 / 已止损的策略可以编辑或删除。结算与取消都会通知订阅成员,取消后的策略成员与订阅圈不再可见。 ## 关于解锁 资讯中心与交易大厅是 [圈子 VIP](/reference/pricing-and-fees) 布局 —— 能看到它们,说明圈主已开通。其余两种版式对所有圈子开放。 ## 相关页面 - [购买与续费会员](/member-guide/membership) - [帖子、投票、提问与文章](/member-guide/posts-and-articles) --- #### 在圈子里聊天 > 四种聊天模式下,你的消息谁能看到、管理组的消息你怎么收。 > > Source: https://docs.ohmy.xin/member-guide/chatting/ 圈子对话的运作方式由圈主设置。加入圈子或模式切换时,机器人会私信告诉你当前聊天模式。模式有四种: ## 静默模式(默认) 静默模式下,你的消息只有圈主、管理员和讲师能看到,他们会引用你的消息回复你;其他成员看不到你的发言。适合以收听为主、私下提问的圈子。 ## 广播模式 广播模式下,管理组发送的消息会推送给全体成员;你发的消息依然只有管理组可见。适合公告与资讯推送型圈子。前一天的广播通常会整理成一条回放。 ## 讲座模式 讲座模式下,管理组的消息全员可见,整场发言会自动录制为回放,结束后可回看。提问可能在开始时是关闭的 —— 等主持人开放提问后再发言,机器人会提示你。 ## 群聊模式 群聊模式下,所有成员都能发言、互相回复,圈子成为一个超级大群。只有开通了圈子 VIP 的圈子可用。消息可能有频率限制和内容过滤。 ## 亲手试一遍 下面的模拟器从**你的视角**还原四种模式:三台手机分别是「你」「圈主阿磊」和另一位成员「小博」。切到某个模式,点任意手机下的按钮发一条消息,看看谁收到、谁显示「未收到」——试过一遍,四种模式的差别就不用背了。 ## 直播间里的聊天 如果圈子正在直播,直播间的聊天也按当前模式显示:成员看到的范围与圈子聊天一致;当前不能发言时,输入框会告诉你原因。主持人切换模式后,房间里的聊天会自动刷新。 ## 两件值得知道的事 - **匿名模式** —— 部分圈子开启匿名发言:普通成员的消息以匿名身份发出,别人看不到你的真实账号。圈主与管理员始终实名;管理员可在你违规时核实你的身份,但不会公开。 - **发送频率** —— 发消息太快时机器人会提醒你「消息发送太频繁,请休息一会」,稍等即可。 ## 相关页面 - [帖子、投票、提问与文章](/member-guide/posts-and-articles) - [观看直播与回放](/member-guide/live) - [账户:资料、火花与离开圈子](/member-guide/your-account) --- #### 帖子、投票、提问与文章 > 时间线里能看到什么,怎么点赞、评论、投票、提问。 > > Source: https://docs.ohmy.xin/member-guide/posts-and-articles/ 圈子的内容大多在时间线里。本页讲清楚你会遇到的内容类型,以及怎么参与。 ## 帖子:点赞与评论 - 点 **点赞** 表达喜欢,再点一次取消。 - 在 **评论** 区回复作者或其他成员;评论发出后无法自行编辑或删除,需要修改时联系圈子管理员。 - 帖子作者可以随时编辑帖子,编辑后会显示「已编辑」标记;作者也可以删除自己的帖子。 - 部分圈子允许成员发帖(由圈主设置「谁可以发帖」);发帖时可以附带图片,或附带一个视频。 ## 投票帖 作者发起投票,选项单选或多选,带截止时间(1 小时到 30 天之间)。投票截止后可以看到每个选项都有谁投过。有的投票帖同时是抽奖帖:投票后自动获得抽奖资格。 ## 向 TA 提问 开启提问的圈子里,帖子下方有「向 TA 提问」。提问后只有你和对方能看到,等待回答期间问题不出现在时间线里。对方回答时可选择 **公开**(所有人可见)或 **私密**(仅你可见)。你可以在「我的提问 / 我的回答」里追踪历史。 ## 文章 文章是圈主或讲师发布的长篇内容,发表后会推送给你。部分文章按合集组织。文章和帖子一样有可见级别:公开、试用、仅会员;如果圈子出售成员档位,还可能标为档位专属。 ## 档位专属内容 如果圈子出售成员档位,部分帖子、文章、策略或公开回答会标为档位专属。没有档位时,你看到的是预览与解锁卡片;购买对应档位后立即展开全文。 档位只解锁内容,不会改变你的角色、会员身份或聊天与活动资格。详见 [购买与续费会员](/member-guide/membership)。 ## 邀请码解锁的内容 部分圈子(多为交易大厅布局)里会有标着「邀请码解锁」的帖子、策略或文章:文章仍能看到标题和开头,并标上「需邀请码解锁」;帖子和策略在时间线里只显示锁定封面。无论哪一种,正文只对圈内指定邀请人邀请来的成员开放。 解锁方法: 1. 在锁定封面上点 **绑定邀请码**,前往 Mixin Rewards 绑定那位邀请人的邀请码 —— 邀请码通常来自把你拉进圈的老成员。 2. 绑定后回到封面,点 **已绑定?重新检测**,通过后即展开全文。 3. 仍未解锁时,说明你绑定的邀请人不在本圈的指定名单里,换一位圈内成员的邀请码再试。 ## 频道 频道是按主题组织帖子的方式。所有人默认在「综合」频道;你可以 **订阅** 感兴趣的频道,让时间线只显示订阅内容。 ## 在时间线里试一遍 下面的实验台把本页讲过的内容类型都摆进了一条时间线:点赞试试「已编辑」标记旁边的按钮;投一票看票数实时更新、截止后才见投票人;提一个问题,等作者公开或私密回答;再用控制台买档位、换邀请码绑定,看档位专属文章与邀请码帖如何解锁;最后点「快讯」订阅一个频道。 ## 如果出了问题 - **带锁的内容看不了** —— 需要会员身份或圈子档位:[购买与续费会员](/member-guide/membership);试用期的圈子可预览部分内容。 - **标着「邀请码解锁」的内容看不了** —— 这类内容凭邀请码开放,与会员身份无关:见上面的「邀请码解锁的内容」。 - **发帖按钮不见了** —— 这个圈子限制了发帖权限(仅管理员或讲师可发)。 ## 相关页面 - [在圈子里聊天](/member-guide/chatting) - [圈子主页:四种布局导览](/member-guide/layouts) --- #### 打赏帖子与成员 > 赞赏一篇帖子或一位成员 —— 对方在 Mixin 钱包直接收到全额打赏。 > > Source: https://docs.ohmy.xin/member-guide/tipping/ 看到喜欢的内容,可以直接用资产表达支持。打赏由平台即时转付:确认支付后,对方会直接在 Mixin 钱包收到全额打赏,平台不抽成、不经手留存。 ## 怎么打赏 1. 在帖子下方点 **赞赏**,或点开成员头像 / 资料页里的 **赞赏** 按钮。 2. 在弹窗里选择金额与资产(该圈子接受的币种)。 3. 点 **用 Mixin Messenger 支付**,确认转账。 4. 几秒内到账,对方直接收到全部金额 —— 平台不抽成。 ## 打赏之后 - 你会看到「打赏已发送」的确认。 - 帖子下方和成员资料页会展示赞赏过的人(头像列表)。 - 打赏完成后,凭支付编号可在 Mixin Messenger 的转账记录中核对。 ## 如果出了问题 - **提示圈子未配置可打赏的代币** —— 圈主还没有设置收款的资产,反馈给管理员即可。 - **支付后对方说没收到** —— 凭支付编号核对这笔转账;到账通常只需几秒。 ## 相关页面 - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [红包、抽奖与问答](/member-guide/luck) --- #### 红包、抽奖与问答 > Oh My Luck 参与指南 —— 领红包、摇号抽奖、答题赢奖池。 > > Source: https://docs.ohmy.xin/member-guide/luck/ 圈主发起的营销互动统称活动:红包、可验证抽奖、答题、Twitter 关注。它们都在 **Oh My Luck** 里运行 —— 圈子里的活动卡片点开即可参与,也可以在 Oh My Luck 机器人里查看。 ## 领红包 1. 点开红包卡片,点 **开红包**(有口令保护的先输入口令)。 2. 领到的钱直接存入你的 Mixin 钱包。 3. 每人限领一次;拼手气或均分由发起人设定。 常见的领取限制:**仅新人**(限最近 24 小时内首次加入的成员)、**按火花**、**Rewards 受邀者**(被邀请来圈内、经 Mixin Rewards 核验)。不满足条件时页面会说明原因。红包过期后,没被领完的部分退回给发起人。 ## 可验证抽奖 1. 点 **摇一摇,抽支签**,你会得到一个编号(号签)。 2. 开奖时间到:所有号签封存后,用公开的 drand 随机信标(League of Entropy 发布)算出中签者。 3. 结果页有完整证明:信标数值、算法、全部号签与中奖者 —— 你可以在浏览器里一键复现验证,无需信任任何人。 4. 报名会在开奖前 1 分钟截止;中奖奖金自动转入你的 Mixin 钱包。 ## 答题 在限定时间内提交答案,按答对数计分。规则在开考前写明:满分可分奖池多少、前 N 名可分多少;同分按提交先后。答题结束后由发起人结算,奖励随即自动发放。 ## Twitter 关注 按提示去 X 关注目标账号,回来报名支持。注意:**平台不核验你是否真的关注了**,报名只是记录。发起人确认成功后,奖池在所有报名者中均分;确认失败则退款给发起人。 ## 查看我的参与 Oh My Luck 的「我的」页可以查看你参与过的活动与结果(待开奖、已中奖、待结算等)。 ## 相关页面 - [打赏帖子与成员](/member-guide/tipping) - [账户:资料、火花与离开圈子](/member-guide/your-account) --- #### 观看直播与回放 > 在哪里找到圈子直播、怎么进入直播间、播放线路与回放。 > > Source: https://docs.ohmy.xin/member-guide/live/ 圈子开直播时,你可以在圈子主页、聊天里的直播卡片或 Oh My Live 目录进入直播间。 ## 找到直播 - **圈子主页** —— 正在直播的直播条会显示观看人数;下一场会显示开播时间。 - **圈子聊天** —— 开播时机器人会发直播卡片,点卡片进入房间。 - **Oh My Live** —— `/live` 目录汇总你所在圈子的正在直播、即将开播与回放。其他圈子的直播也会列出,但观看仍需先加入那个圈子。 预约直播可以点 **开播提醒**;开始前机器人会发消息提醒。 ## 在直播间里 - 点画面上的播放按钮开始观看;顶部显示主播、正在观看人数与已开播时长。 - 播放线路会按你的网络自动选择。判断不出来时会让你选:**境外网络**(超低延迟,约 1 秒,不可用时自动回退)或 **中国大陆网络**(标准播放,最稳定)。选择会记住,之后可从直播间顶部随时切换。 - 直播间聊天与圈子聊天同步,并沿用圈子的[聊天模式](/member-guide/chatting)。当前不能发言时,输入框会告诉你原因。 - 直播结束或取消后,画面会显示状态;有回放时可以直接进入回放。 ## 进直播间试试 下面的演示还原了真实的直播间。点画面上的「点击观看」——如果你的网络判断不出来,直播间会请你选线路;再用右侧控制台切换网络和聊天模式,看看房间、输入框和提示如何跟着变化。 ## 回放 - 直播回放保存在圈子的回放列表里,也可以在 Oh My Live 的回放区找到。 - 回放页沿用直播间的样子,可以按分段跳到不同部分。 ## 如果出了问题 - **打不开直播** —— 直播可能还没开始、已经结束或已取消;刷新页面看状态。 - **画面卡顿** —— 从直播间顶部切换播放线路;在中国大陆网络下建议选「中国大陆网络」。 - **不能发消息** —— 当前聊天模式不允许你发言,输入框会说明原因;开放答疑或切换模式后再试。 - **看不到某个圈子的直播** —— 需要先加入那个圈子;「仅成员」的直播不会出现在公开目录。 ## 相关页面 - [在圈子里聊天](/member-guide/chatting) - [圈子主页:四种布局导览](/member-guide/layouts) - [购买与续费会员](/member-guide/membership) --- #### 账户:资料、火花与离开圈子 > 「我的」页全导览 —— 会员状态、通知偏好、火花积分与退出圈子。 > > Source: https://docs.ohmy.xin/member-guide/your-account/ 圈子的 **我的** 页是你在这圈子里的个人中心:会员状态、订单、通知偏好、邀请与设置都在这里。 ## 你的身份就是 Mixin 账号 OhMy.xin 不需要另外的资料设置:头像与昵称直接来自你的 Mixin 账号。你管理的是每个圈子里的偏好,而不是一份新档案。 ## 通知偏好 在「通知偏好」里逐项开关:新帖子、圈主发帖、新评论、点赞、打赏广播、红包领取、新成员加入,以及是否订阅圈子消息。关掉的不打扰你,开着的第一时间知道。 ## 火花 火花是鼓励持续参与的积分: - **怎么赚** —— 阅读帖子、回应、评论、发帖、聊天都有分,每天有上限;每天第一次有效行为会延续你的连续天数。 - **等级** —— 累计积分点亮五级:余烬、星火、火焰、烈焰、灯塔。 - **只属于你** —— 没有公开排行榜;积分不能消费、转账或兑付。部分活动的红包会按火花开放领取。 ### 试着点亮一天 下面的实验台还原了积分与连续天数:点任意行为按钮看看今天的第一步怎么点亮连胜、附加奖励怎么随天数增长(封顶 +7);再用「到明天」延续、用「消失两天」看清零规则 —— 当前连续归零,但最长连续和累计积分永远保留,等级也不会倒退。 ## 长时间不来会怎样 如果圈主设置了非活跃周期,你长时间没打开 Mixin 时会先收到提醒(最多三次);之后圈子消息会暂停发给你。**重新打开 Mixin 即自动恢复**,不需要联系任何人。 ## 离开圈子 在 **我的** 页底部点 **离开**,确认后即退出:不再收到圈子的任何消息,也无法再访问圈子内容。免费圈子随时可以重新加入;付费圈子重新加入需要恢复会员。 ## 相关页面 - [购买与续费会员](/member-guide/membership) - [红包、抽奖与问答](/member-guide/luck) --- #### 购买与续费会员 > 挑套餐、付款、查看到期时间 —— 会员的完整生命周期。 > > Source: https://docs.ohmy.xin/member-guide/membership/ 会员按圈主设定的套餐计费。本页讲清楚套餐怎么挑、钱怎么付、到期了怎么办。 ## 挑一个套餐 圈子会采用其中一种定价方式: - **固定价格** —— 只有一个价格和时长(按年或按月)。 - 订阅套餐 —— 多个命名套餐供选择,比如「月度」「年度」,不同时长不同价格。 订阅套餐可能带有**首次优惠价**:第一次购买比原价便宜,续费恢复原价;固定价格方式没有首次优惠价。挑好后按 [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) 完成付款,几秒内生效。 ## 成员档位(Pro 内容) 有些圈子还出售**成员档位**:照常免费或付费进圈后,再单独购买档位解锁更深的内容。入口在圈子会员页的「成员档位」区块,或内容上的解锁卡片。 - 档位只解锁内容,不改变你的角色、会员身份、聊天权限或红包与抽奖资格。 - 档位到期后,档位专属内容重新上锁,其他一切不变;机器人会发消息提醒你续订,随时可以再买。 - 已经持有有效档位时不能重复购买,到期后才能再次购买。 - 如果进圈会员先到期,即使档位仍在有效期,也要先续费进圈才能阅读档位内容;续费后剩余的档位时间照常保留。 ## 续费有折扣 到期前圈子会提醒你续费。很多圈子给老会员**续费折扣**,续费页会直接显示折后价。续费时长叠加在现有到期时间上,不会浪费剩余天数。 ## 到期后会怎样 会员到期后你变成[过期成员](/member-guide/joining):会员内容重新上锁,但你的资料和互动记录都保留。随时续费立即恢复。 ## 把生命周期走一遍 有效期怎么算,走一遍最直观。下面的实验台从加入带 7 天试用期的付费圈子开始:先在试用里买一单(看首次优惠价、看会员期从哪天起算),再快进到到期前后分别续一单 —— 提前续费是叠加,过期后再买是从购买日重新起算、空窗不补。也可以切到「固定价格」方式,看续费折扣只在还是成员时有效。 ## 其他两件小事 - **收到赠礼** —— 圈主可能直接为成员赠送会员时长,到账后到期时间自动延长。 - **查状态与记录** —— 「我的」页可以随时查看会员到期时间和全部订单;每笔订单凭支付编号可核对到 Mixin 转账。 ## 如果出了问题 - **支付后会员没有生效** —— 等几秒后刷新;仍未生效时在订单页用支付编号查询,或联系圈子管理员。 - **想换套餐** —— 直接购买新套餐即可,时长自动叠加;如有差价疑问联系圈子管理员。 ## 相关页面 - [加入圈子:免费、付费与试用](/member-guide/joining) - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [定价与费用一览](/reference/pricing-and-fees) --- #### 资讯订阅 > 关注资讯源,打造个性化信息流,控制推送。 > > Source: https://docs.ohmy.xin/member-guide/story-subscriptions/ 资讯中心布局的圈子会订阅外部内容源(X (Twitter)、YouTube、Telegram、Discord 等),把优质内容以「资讯」的形式搬进圈子里。你可以只关注自己喜欢的部分。 ## 关注资讯源 1. 进入圈子的 **资讯源** 页,浏览可关注的来源。 2. 点 **关注** —— 该源的资讯会进入你的个性化时间线。 3. 「资讯」页里可切换视图:只看已关注、看圈子讨论、或看全部。 刚加入时,圈主可能为你准备了一份**入门精选**:机器人发来精选的资讯源卡片,点卡片上的**关注**即可一步订阅,不感兴趣也可以直接忽略。 ## 控制推送 - 每个已关注的源都有独立的 **推送通知** 开关,默认开启。 - 在「通知偏好」页可以统一管理所有已关注源的推送。 - 新资讯发布时,机器人会发来一张可 **阅读** 与 **评论** 的卡片;关闭推送则只安静地留在时间线里。 - 试用期的成员收到的资讯卡片会附带试用剩余天数提醒。 ## 在这里试一遍 下面的实验台还原了完整链路:先从入门精选卡片关注一两个源,再试试开关推送、取消关注,然后用「发一条新资讯」看看什么情况下机器人会发卡(可阅读、可评论)、什么情况下它保持安静。 ## 如果出了问题 - **关注后时间线还是空的** —— 新资讯发布后才会出现;先切到「全部」看看这个圈子已有的内容。 - **不想收推送但想保留关注** —— 关掉该源的推送开关即可,关注关系不受影响。 ## 相关页面 - [圈子主页:四种布局导览](/member-guide/layouts) - [账户:资料、火花与离开圈子](/member-guide/your-account) ### Creator guide / 创作者指南 #### 上线清单 > 控制台「今日」页的四步引导,从接入完成到正式开门。 > > Source: https://docs.ohmy.xin/creator-guide/launch-checklist/ 接入完成后,控制台「今日」页会列出四项基础设置,完成一项自动打勾。其中两项按配置完成才算:开启收费后「检查入圈与费用」才会打勾,选择默认经典布局之外的版式后「选择公开布局与外观」才会打勾 —— 全部打勾,圈子就具备正式运营的条件。 ## 清单四项 1. **设置欢迎卡与简介** —— 成员进圈第一眼看到的内容:一句欢迎语,加上圈子是做什么的。 2. **检查入圈与费用** —— 设定价格与收费;开启收费后此项才打勾(见 [会员与定价](/creator-guide/membership-and-pricing))。 3. **选择公开布局与外观** —— 圈子主页的版式;保持默认的经典布局时此项不会打勾。 4. **配置邀请推广** —— 写好随邀请卡片展示的推广文案,让每次转发都能带来新成员。 ## 先在这里试一试 逐项填写,看它像在控制台里一样自动打勾。手机里展示成员会看到什么;留空的地方会显示通用文案,用黄色标出。 ## 在控制台里 [Screenshot: 控制台「今日」页的新手引导清单] ## 怎么用 清单会一直挂在「今日」页,完成一项自动打勾。日常运营(待处理、内容、数据)走左侧导航,不受清单影响。 ## 上线之后 - 把邀请链接分享到你的群聊或社交媒体。 - 观察「今日」页的运营状态:待审核内容、新成员、收入概览。 - 逐步丰富内容:帖子、文章、频道,以及幸运活动。 ## 相关页面 - [会员与定价](/creator-guide/membership-and-pricing) - [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin) - [定价与费用一览](/reference/pricing-and-fees) --- #### 会员与定价 > 定价方式、计费周期、试用与邀请奖励 —— 收入端的所有选项。 > > Source: https://docs.ohmy.xin/creator-guide/membership-and-pricing/ 控制台的「入圈与价格」设置决定成员怎么付费。所有选项都可以随时调整,改完即生效。 ## 两种定价方式 - **固定价格** —— 一个价格配一种时长,适合定价简单的圈子。 - **订阅方案** —— 创建多个命名方案(如「月度」「年度」),各自定价,供成员挑选。方案可以设置**首次优惠价**:新成员首单享受优惠价,续费恢复标准价。 ## 成员档位:给 Pro 内容单独定价 除了进圈费,你还可以卖一层 Pro 内容:成员照常进圈,再单独购买档位解锁更深的内容。 - 位置:控制台 → 收入 → 成员档位。填写档位名称、说明、价格、币种与时长。时长按月份填写;留空表示永久档位,但当前阶段永久档位不对成员开售。 - 档位是独立的产品:它不影响进圈费用,也不会改变成员的角色或会员到期时间。档位到期只是重新锁上档位内容。 - 发布时选择「阅读权限」:帖子、文章、策略与问答的公开回答都可以指定给某个档位;不指定的内容所有人可见。没有档位的成员会看到预览与解锁卡片。 - 购买走和进圈相同的支付流程,平台服务费与邀请奖励同样适用。 **成员档位不是圈子 VIP。** 圈子 VIP 是你向平台购买的功能订阅(布局、资讯源、群聊模式等);成员档位是你卖给成员的内容层级。 ## 计费周期与时长 - **年付** —— 统一 12 个月。 - **月付** —— 可以开放多个时长档(如 1 个月、12 个月)供成员挑选。 ## 三个调节收入的选项 - **试用天数** —— 新成员先免费体验若干天再开始计费;设为 0 表示不提供试用。 - **续费折扣** —— 老会员续费享受折后价,鼓励长期留存。 - **邀请奖励比例** —— 成员邀请的新人付款后,邀请人按此比例从订单中获得奖励(上限 89%)。设为 0 表示关闭。这是自带裂变的获客手段,代价是让出一部分收入。 ## 成员能用什么付款 从平台支持的资产(USDT、PUSD、USDC、BTC、ETH、XIN、DOGE、EOS、BOX)中挑选圈子接受的币种,成员支付时从中选择。 ## 收入怎么结算 每笔会员或成员档位订单:平台收取 10% 服务费,邀请奖励按比例分给邀请人,其余归你,由平台按单即时转入你的 Mixin 钱包,通常几秒到几分钟到账,无需提现。完整数字见 [定价与费用一览](/reference/pricing-and-fees)。 ## 相关页面 - [上线清单](/creator-guide/launch-checklist) - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [定价与费用一览](/reference/pricing-and-fees) --- #### 内容审核 > 待处理队列、防骚扰规则、拉黑与撤回 —— 保持圈子干净的全部手段。 > > Source: https://docs.ohmy.xin/creator-guide/moderation/ 审核的日常入口是控制台 → **待处理**:需要你判断的事情都汇集在这里,包括待审核垃圾信息、刷屏警报、待发布资讯与抓取失败的资讯源。 [Screenshot: 控制台「待处理」队列,有被拦截的垃圾信息和一条刷屏警报] ## 防骚扰规则 设置 → 防骚扰: - **启用垃圾信息防护** —— 可疑消息先被扣下、不送达成员,进入待处理队列由你定夺。 - **严格程度** —— 宽松 / 均衡 / 严格,决定拦截的灵敏度。 - **链接策略** —— 允许链接、拦截链接、或仅允许白名单里的域名。 - **新成员审查** —— 新成员的前 N 条消息重点检查(0 = 平台默认 5 条)。 - **自定义关键词** —— 拦截词与放行词(放行词可覆盖误判),支持整条匹配、短语匹配、任意位置匹配。 [Screenshot: 控制台设置中的「防垃圾」分区] 被拦截的消息有四种处理:**批准放行**(误判)、**确认为垃圾**、**确认并拉黑**、**忽略**。批准放行与忽略支持 10 秒内撤销;确认为垃圾与确认并拉黑为最终操作,不可撤销。 ## 在这里试一遍 下面的实验台把这套规则搬了过来:左边改设置(严格程度、链接策略、拦截词/放行词、发送者身份),写一条消息或直接点预设,右边立刻看到它送达成员、还是被扣进「待处理」以及为什么;被扣的消息可以试那四种处理 —— 批准与忽略带撤销,确认与拉黑是最终的。 ## 刷屏警报 平台自动识别异常刷屏与重复发送,即使你没有配置任何规则。确认警报会拉黑该成员并批量撤回其窗口期内的消息;误报可直接忽略。成员页的「加入高峰」探测帮你发现异常的集中入圈。 ## 拉黑、撤回与匿名核实 - **拉黑成员** —— 成员页操作,或引用消息发 `/block`。拉黑后其撤回窗口(30 天)内的消息会被批量撤回。 - **撤回消息** —— 引用消息发 `/recall`,或在控制台 → 群聊 → 消息里按条撤回;只限最近 30 天内。 - **匿名核实** —— 匿名模式下普通成员匿名发言,但圈主和管理员可引用消息发 `/reveal`,机器人私信告诉你其真实身份,不会公开。 ## 变更记录 所有审核与管理动作(模式切换、拉黑、规则修改等)自动写入设置 → 变更记录,可撤销的操作支持一键回退;拉黑等敏感操作还会私信通知圈主。 ## 相关页面 - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) - [成员与角色](/creator-guide/members-and-roles) --- #### 内容工具箱 > 帖子、文章、频道、友情链接、分享应用与各布局专属内容。 > > Source: https://docs.ohmy.xin/creator-guide/content-toolkit/ 控制台 → **内容** 集中了所有可以发布与编排的东西。先建内容,再决定它展示在哪里。 ## 帖子与文章 - **帖子** —— 支持图片或单个视频(视频 ≤200 MB,需圈子 VIP)、投票帖、抽奖帖、提问帖。可置顶(每频道一篇)、移动频道、推送通知。成员是否可以发帖由「谁可以发帖」决定。 - **文章** —— 长篇内容,发表后推送给订阅成员;可见级别分公开 / 试用 / 仅会员。 - **文章合集** —— 把文章按顺序组织成学习路径或专题,同样支持可见级别。 - **阅读权限** —— 如果圈子设置了[成员档位](/creator-guide/membership-and-pricing),帖子、文章、策略与公开回答可以指定给某个档位;不指定则所有人可见。 ## 频道 按主题给帖子分栏。所有人默认在「综合」频道,其余频道由你创建;成员订阅后时间线按频道过滤。建议控制在 5 个以内,只有你授权的成员能在指定频道发帖。 ## 视频直播(Oh My Live) VIP 圈子可以向成员开视频直播:控制台 → 内容 → 直播。 - 发起直播:填标题、封面,选择立即开播或预约时间;观众范围选「仅成员」或「在 Oh My Live 展示」。 - 开播后成员会在圈子聊天收到直播卡片,圈子主页也会出现直播入口;预约直播可以提前设提醒。 - 结束后生成回放。控制台的直播页按正在直播、即将开始与历史场次分组,并显示本月已用直播分钟数。 直播需要平台为你的圈子开通;未开通时控制台不会出现「直播」入口。完整操作见 [视频直播(Oh My Live)](/creator-guide/live-streams)。 ## 友情链接 把其他 Mixin 机器人(包括平台上托管的圈子)作为卡片放到服务页,支持描述与标签(最多 5 个标签,每个 ≤20 字)。它同时驱动资讯中心的「推荐机器人」页和交易大厅的机器人筛选标签。 ### 在这里试一遍 下面编辑一条友情链接,看同一份数据如何出现在三个页面:服务页卡片、资讯中心的推荐机器人、交易大厅的筛选标签。标签按逗号分隔、最多 5 个、每个不超过 20 字 —— 超限会被拒绝而不是悄悄截断;隐藏则让它从三处同时消失。 ## 分享应用 控制台 → 内容 → 分享应用:把其他 Mixin 机器人添加到你机器人的名片上,成员打开名片即可看到、直接进入。输入对方机器人的 Mixin ID 添加,随时可移除。适合把你的其他圈子或合作方机器人放到一起曝光。 ## 各布局的专属内容 - **资讯中心** —— 外部资讯源(X、YouTube、Telegram、Discord,需 [圈子 VIP](/reference/pricing-and-fees)):每个源可自动发布、推送开关、独立图标;为新成员配置最多三个来源的入门精选。 - **交易大厅** —— 策略(入场 / 目标 / 止损位与状态)、直播课程(开播提醒)、[展示页面与展示卡片](/creator-guide/showcase-pages-cards)(胜率与带单场次)、邀请码解锁的锁定帖(资格由 [Mixin 返佣](/creator-guide/insights-and-growth) 决定)。策略不只在控制台:圈主和管理员也可以直接在成员端新建与维护,见 [四种布局导览](/member-guide/layouts)。 ## 相关页面 - [选择你的布局](/creator-guide/choosing-your-layout) - [资金:订单与到账](/creator-guide/money-orders-payouts) --- #### 创作者指南 > 从零创建圈子到日常运营 —— 控制台各功能的完整手册。 > > Source: https://docs.ohmy.xin/creator-guide/ 这里收录圈主与运营者需要的全部指南:创建、定价、审核、内容、资金与增长。 [Screenshot: 控制台一打开就是「今日」页。] ## 本节内容 - [开始之前:费用与准备](/creator-guide/before-you-begin) - [在 Mixin 创建机器人](/creator-guide/create-your-bot) - [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin) - [上线清单](/creator-guide/launch-checklist) - [会员与定价](/creator-guide/membership-and-pricing) - [选择你的布局](/creator-guide/choosing-your-layout) - [定制资讯中心](/creator-guide/customize-story-hub) - [定制交易大厅](/creator-guide/customize-trading-hub) - [首页入口](/creator-guide/home-entries) - [展示页面与展示卡片](/creator-guide/showcase-pages-cards) - [欢迎体验设置](/creator-guide/welcome-experience) - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) - [消息模板与主动推送](/creator-guide/message-templates-and-broadcasts) - [内容审核](/creator-guide/moderation) - [内容工具箱](/creator-guide/content-toolkit) - [视频直播(Oh My Live)](/creator-guide/live-streams) - [资讯源管理](/creator-guide/story-feeds-and-sources) - [资金:订单与提现](/creator-guide/money-orders-payouts) - [幸运活动:红包、抽奖与问答](/creator-guide/luck-campaigns) - [积分火花](/creator-guide/spark-points) - [成员与角色](/creator-guide/members-and-roles) - [数据与增长](/creator-guide/insights-and-growth) - [设置参考](/creator-guide/settings-reference) - [圈子 VIP](/creator-guide/circle-vip) - [生命周期:休眠、重连与转让](/creator-guide/lifecycle) 还没创建圈子?从 [创建自己的圈子](/start-here/create-a-circle) 开始。 --- #### 圈子 VIP > VIP 解锁什么、多少钱、怎么续费,到期后会发生什么。 > > Source: https://docs.ohmy.xin/creator-guide/circle-vip/ 圈子 VIP 是可选的高级功能订阅,按圈计费。入口:控制台 → 收入 → 升级 VIP。 > **和成员档位不是一回事** > 圈子 VIP 是圈主向平台购买的功能订阅(布局、资讯源、群聊模式等);成员档位是你卖给成员的 Pro 内容层级(控制台 → 收入 → 成员档位)。两者独立设置、独立计费,详见[会员与定价](/creator-guide/membership-and-pricing)。 > [Screenshot: 已开通 VIP 的圈子的「升级 VIP」页] ## 解锁的功能 - **资讯中心** 与 **交易大厅** 两种 [布局](/creator-guide/choosing-your-layout) - **群聊模式** —— 全员互聊的超级大群 - **自定义支付币种** —— 不限默认币种接收付款(收入 → 货币) - **资讯源** —— 外部内容订阅(见[资讯源管理](/creator-guide/story-feeds-and-sources)) - **抽奖与红包的参与者过滤** —— 按自定义条件筛选可参与者 - **视频帖子** —— 帖子附带短视频,自动生成封面 - **视频直播** —— 面向成员的直播、聊天内直播卡片、低延迟直播间与回放(平台为圈子开通后可用;见[视频直播](/creator-guide/live-streams)) ## 价格与支付 | 周期 | 价格 | | --- | --- | | 月付 | $9.99 | | 季付 | $29.99 | | 年付 | $99.99 | 支持 BTC、PUSD、USDT、XIN 支付,订单 15 分钟内有效。数字以 [定价与费用一览](/reference/pricing-and-fees) 为准。 ## 续费与到期 - **续费从当前到期日顺延**,不会损失剩余天数;支付后立即生效。 - 到期前 7 天,「今日」页会出现 **VIP 即将到期** 提醒,可直接发起续费订单。 - **到期不会拆除任何东西**:已启用的布局与内容照常运行;只是不能再切换到 VIP 布局、开启群聊模式或使用资讯源管理等功能。 - 续费还会顺带解除 [休眠](/creator-guide/lifecycle) 状态。 ## 相关页面 - [选择你的布局](/creator-guide/choosing-your-layout) - [生命周期:休眠、重连与转让](/creator-guide/lifecycle) --- #### 在 Mixin 创建机器人 > 在 developers.mixin.one 免费注册机器人,拿到 OhMy.xin 需要的两样东西:keystore.json 和 Client Secret。 > > Source: https://docs.ohmy.xin/creator-guide/create-your-bot/ 每个圈子都跑在一个属于你自己的 Mixin 机器人上。机器人在 Mixin 开发者网站上免费注册,做完你手里会多出 **两样东西**:一个叫 `keystore.json` 的文件,和一串叫 **Client Secret** 的字符。 > **30 秒版本** > 在 [developers.mixin.one](https://developers.mixin.one/dashboard):**New App** → **Save** → **Secret** 标签页 → **App Session:Generate a new key**(Download 下载 `keystore-7000101234.json`,以机器人的 Mixin ID 命名)→ **OAuth Client Secret:Generate a new secret**(Copy 复制)。然后把这两样交给 OhMy.xin。建议用电脑操作 —— 要来回搬一个文件。 > ## 先在这里点一遍 下面从头到尾点一遍:前半段在 Mixin 上,后半段在 OhMy.xin 上。留意浏览器下方的托盘 —— 每拿到一样东西,它就会装进去。 ## 两样东西,对照着看 > **像对待钱包一样对待 keystore.json** > 谁拿到它,谁就能以机器人的身份发消息、动用机器人钱包。**只**在 OhMy.xin 的创建向导里上传,绝不发给任何人 —— 包括自称官方客服的人。万一泄露,在 App Session 卡片重新点 **Generate a new key**,旧文件即刻失效。 > ## 如果出了问题
扫码后登录不上 要在 Mixin Messenger 里面扫(右上角的扫一扫),不要用手机相机,并确认 Messenger 是最新版。
Save 按钮点不了或保存失败 检查每一项是否都填了。Mixin 曾要求简介至少 16 个字符,两个 URL 都要以 `https://` 开头。随便填个 https 地址即可,OhMy.xin 稍后会改写。
还没下载或复制就把弹窗关了 Mixin 不保存这两样,没法再显示。重新生成即可 —— keystore 点 **Generate a new key**,Client Secret 点 **Generate a new secret** —— 在 OhMy.xin 里用最新的。
找不到下载的文件 打开浏览器的下载列表(Ctrl+J / ⌘⇧J)。找 `keystore-` 加上机器人 Mixin ID 的文件,比如 `keystore-7000101234.json`。重复下载的文件名可能带编号,比如 `keystore-7000101234 (1).json`,没关系。如果点了两次,用最新的那个。也可以不用文件:在 App Session 弹窗点 **Copy**,把内容粘贴到 OhMy.xin。
## 相关页面 - [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin) - [你的 Mixin 账号与 Mixin ID](/mixin-basics/your-mixin-account) - [在 Mixin 里保持安全](/mixin-basics/staying-safe) --- #### 定制交易大厅 > 主页频道、底部导航与展示页面 —— 布局定制抽屉逐项讲解与交互演示。 > > Source: https://docs.ohmy.xin/creator-guide/customize-trading-hub/ 交易大厅的定制抽屉有四个标签页:**布局**(主页频道与底部导航)、**首页入口**、**展示页面**、**展示卡片**。入口同样是 控制台 → 设置 → 外观 → 布局定制;只有圈主和管理员可以修改。 ## 主页频道 成员主页顶部的频道导航由三个频道槽位决定: - 每个槽位选择 **广场**(帖子流)、**课程**(直播日历)、**策略**(信号面板)之一,或「— 不启用 —」。 - **槽位顺序就是显示顺序**:把策略放在第一个,成员打开主页先看到策略面板。 - 同一频道选了两次会被**忽略**,按第一次出现的槽位保留。 - 每个频道可填**自定义名称**(≤20 字),覆盖默认名「广场 / 课程 / 策略」。 - 保存时校验:频道过多、包含未知或重复频道、频道名称过长都会被拦下。 停用一个频道只是把它从主页隐藏 —— 帖子、课程、策略内容都在,重新启用即恢复。 ## 底部导航 - **「主页」与「我的」固定显示**,不可配置。 - 中间最多 **三个槽位**,每个指向一个已创建的展示页面;空槽自动收起。 - 每个槽位可填**文案**(≤20 字),覆盖页面标题显示在标签上 —— 比如页面叫「策略服务」,标签上可以只写「服务」。 - 圈子还没有展示页面时,抽屉会提示先去创建。 - 页面后来被删除,指向它的槽位会被自动移除。 槽位与页面的完整语义 —— 卡片如何按标签命中页面、页面如何到达成员端 —— 见 [展示页面与展示卡片](/creator-guide/showcase-pages-cards),那一页有完整的交互演示。 ## 展示页面与展示卡片标签页 抽屉里的这两个标签页就是展示页面 / 展示卡片管理的快捷入口:在抽屉里直接新增、编辑与删除,不必跳转到控制台的其他页面。人物卡片的胜率与带单场次也在这里维护。 ## 首页入口标签页 成员主页频道导航上方的**快捷入口**胶囊行就是首页入口。每张卡片有标题(≤80 字)、可选描述(≤500 字)、图标与排序;列表、新增、编辑与删除都在这个标签页里完成。 - 交易大厅的招牌用法是**展示页面**跳转:填入服务页的数字 ID,成员从胶囊行一步直达策略服务页。 - 再配一条**外部链接**(行情站)与一个**文章合集**(入门课程),付费内容三步可达。 - 其余十余种跳转目标(文章、会员、机器人入口、文件夹……)同样可用,完整清单与隐藏条件见 [首页入口](/creator-guide/home-entries)。 上面的演示里切到「首页入口」标签页即可试:清空槽位胶囊即收起,文案覆盖默认名,点「策略服务」胶囊成员端直达该页。 频道内的帖子、课程与策略内容仍在各自的管理页维护,不在抽屉里。 ## 信号导入 平台为圈子开通信号来源后,交易大厅控制台的「策略管理 → 信号导入」标签页会出现对应的设置块:是否导入、导入后是**存为草稿**等你审核还是**自动发布**、只接收某个计划或某个分析师的信号、以及这些策略挂谁的名(默认圈主)。 - 平台没开通的来源不会出现在设置里;出现在设置里的来源默认是关闭的。 - 存为草稿时,信号只出现在控制台的策略列表里,成员端看不到、不进资讯中心;你在控制台点「发布」之后才会公开。 - 自动发布时,信号一到就成为公开策略,成员会收到通知。 平台只负责开通「哪个圈子能接哪个来源」,剩下的由圈子自己决定。 ## 切换布局会丢掉这些设置吗? 不会。频道与导航配置存在圈子的布局设置里,切到其他布局再切回交易大厅,配置原样保留。 ## 相关页面 - [展示页面与展示卡片](/creator-guide/showcase-pages-cards) - [首页入口](/creator-guide/home-entries) - [定制资讯中心](/creator-guide/customize-story-hub) - [选择你的布局](/creator-guide/choosing-your-layout) --- #### 定制资讯中心 > 导航标签、来源与资讯的叫法、首页标题与横幅 —— 布局定制抽屉逐项讲解与交互演示。 > > Source: https://docs.ohmy.xin/creator-guide/customize-story-hub/ 资讯中心是可定制项最多的布局之一。打开 **控制台 → 设置 → 外观**,在资讯中心的布局卡上点「布局定制」,右侧抽屉分「布局」「首页入口」两个标签页:「布局」是全部外观定制项,「首页入口」管理成员首页的快捷入口(见[下文](#首页入口标签页))。只有圈主和管理员可以修改。 左边是模拟的定制抽屉,右边的手机预览实时反映每条规则: - **导航标签**不仅改底部导航,也改各页面的标题;来源、资讯两个标签留空时,默认值跟随「叫法」设置。 - **叫法**一次改名,成员端所有提到「来源」「资讯」的文案(引导语、关注数、首页入口)全部跟随。 - **首页标题**留空回退为圈子名称;**副标题**留空则整行不显示。 - **横幅**以全幅背景渲染,上面压深色渐变保证文字可读。 ## 试试这些实验 1. 把「来源标签」改成「电台」,再清空 —— 清空后它跟随「来源叫法」的默认值。 2. 把「来源叫法」改成「快讯」:底部导航、来源页引导语、首页「热门来源」入口一起变。 3. 清空首页标题输入框(页面加载时它就是空的):大标题回退成圈子名称「每日笔记」。 4. 勾选示例横幅:首页顶部变成带深色渐变的全幅横幅样式。 5. 切到「首页入口」标签页,取消勾选「💼 开通会员」:首页目录里这张卡消失;重新勾选即恢复 —— 停用的入口还在管理列表里。 ## 抽屉里的每一项 ### 导航标签 | 字段 | 默认 | 限制 | 生效位置 | | --- | --- | --- | --- | | 首页标签 | 首页 | ≤40 字 | 底部导航第 1 个标签;主页标题 | | 来源标签 | 来源 | ≤40 字 | 底部导航第 2 个;来源页标题 | | 资讯标签 | 资讯 | ≤40 字 | 底部导航第 3 个;资讯页标题 | | 我的标签 | 我的 | ≤40 字 | 底部导航第 4 个;「我的」页标题 | ### 叫法 | 字段 | 默认 | 限制 | 说明 | | --- | --- | --- | --- | | 来源名称 | 来源 | ≤40 字 | 成员端所有「来源」字样的替代词 | | 来源复数 | 来源 | ≤40 字 | 仅非中文圈子显示;中文圈子自动跟随单数 | | 资讯名称 | 资讯 | ≤40 字 | 成员端所有「资讯」字样的替代词 | | 资讯复数 | 资讯 | ≤40 字 | 仅非中文圈子显示;中文圈子自动跟随单数 | 叫法会渗入成员端的各类文案 —— 引导语、关注按钮、空状态提示等。改叫法不会改动数据本身:已有的资讯源、订阅关系都不受影响,只是换了个称呼。 ### 首页文案 | 字段 | 默认 | 限制 | 生效位置 | | --- | --- | --- | --- | | 首页标题 | 无 | ≤120 字 | 成员首页大字标题;留空回退圈子名称 | | 首页副标题 | 无 | ≤120 字 | 标题下副行;留空不显示 | | 首页横幅 | 无 | JPEG / PNG / WebP / GIF,≤5 MB,建议宽横图约 3:1 | 首页顶部全幅背景;保存后可勾选「移除当前横幅」 | | 来源目录介绍 | 无 | ≤2000 字 | 可填写保存;当前版本暂未在成员端展示 | :::note[首页公告不在这里] 定制抽屉里有张提示卡:首页公告请使用**通知栏**,或直接置顶帖子 —— 不属于布局定制。 ::: ## 首页入口标签页 抽屉的「首页入口」标签页管理成员首页的快捷卡片:每张有标题(≤80 字)、可选描述(≤500 字)、图标与排序,点开即达圈内页面或外部网站。列表、新增、编辑与删除都在抽屉里完成,交互与展示页面 / 展示卡片标签页一致。 - 跳转目标覆盖**圈内内容**(文章、合集、来源目录、单个来源、新手指南)、**成员自助**(订单、会员、提问、红包……)与**机器人 / 外链**,十余种 —— 完整清单见 [首页入口](/creator-guide/home-entries)。 - **文件夹**只能放在顶级,用来收纳同类入口。资讯中心的典型用法是把新手指南、一个学习路径合集与一个精选资讯源收进「新手入门」文件夹,旁边再放「开通会员」入口 —— 新手路径与转化路径直接摆在首页上。 - 跳转目标还没填、问答 / 红包未开启等情况会让入口对成员隐藏,管理列表会逐条标注原因(完整规则见 [首页入口](/creator-guide/home-entries))。 入门精选(新成员入圈自动收到最多三个精选资讯源卡片)不在抽屉里,在 [内容工具箱](/creator-guide/content-toolkit) 配置。 ## 抽屉之外,资讯中心还有这些专属配置 - 资讯源分类的排序、来源标签组(最多 4 组,每组文案 ≤20 字)在 [资讯源管理](/creator-guide/story-feeds-and-sources) 页配置。 ## 切换布局会丢掉这些设置吗? 不会。定制存在圈子的布局设置里,与当前使用哪个布局无关:切到交易大厅再切回来,标签、叫法与横幅原样保留。 ## 相关页面 - [选择你的布局](/creator-guide/choosing-your-layout) - [定制交易大厅](/creator-guide/customize-trading-hub) - [首页入口](/creator-guide/home-entries) - [资讯源管理](/creator-guide/story-feeds-and-sources) --- #### 展示页面与展示卡片 > 交易大厅里页面按标签收集卡片、底部导航把页面带给成员 —— 亲手配一遍就懂了。 > > Source: https://docs.ohmy.xin/creator-guide/showcase-pages-cards/ [交易大厅](/creator-guide/choosing-your-layout)的控制台里,「内容 → 展示页面与卡片」是两份互不隶属的清单,初看很容易迷惑:展示卡片不属于任何一个页面,展示页面也不装任何内容。把三条规则记住,配置就顺了: 1. **页面按标签捞卡片。** 页面写「筛选标签」,卡片写「展示标签」,只要命中任意一个,卡片就出现在这个页面上。一张卡片可以同时被多个页面捞到。 2. **一个筛选标签都不选的页面,显示全部卡片。** 反过来,没有展示标签的卡片,只会出现在这种「全量页面」上。 3. **页面要被成员看到,必须占一个底部导航槽位。** 主页和我的固定不变,中间最多三个页面槽位。 ## 在这里试一遍 左侧是模拟控制台,右侧是成员手机。每一步改动都会立刻反映到手机上。 建议按这个顺序动手: - 关掉「讲师团队」页面的「讲师」筛选标签 —— 手机里页面清空,出现「没有卡片命中」。 - 把所有筛选标签关掉 —— 页面变成显示全部四张卡片(规则 2)。 - 给「新手交流群」加上「讲师」展示标签 —— 它立刻出现在讲师团队页。 - 把槽位 1 设为「空槽位」—— 手机底部对应的标签页消失;再点「预览」,页面上出现 ⚠ 警告:成员到不了这里(规则 3)。 - 点卡片的「点击动作」循环切换,再在手机里点同一张卡片,看详情页、联系人、外链、无动作四种结果。 ## 卡片的两种样式 | | 人物卡片 | 群组卡片 | |---|---|---| | 图片 | 头像 | 封面 | | 数据 | 胜率(0–100)、带单场次 | 亮点(最多 3 条,每条 ≤40 字) | | 徽章 | — | VIP | | 默认按钮 | 查看主页 | 联系助理 | | 特殊用途 | 可作为直播课程的**主讲** | 服务与社群展示 | 人物卡片可以绑定一位圈内成员,头像、名称和联系人名片直接来自这位成员;不绑定也可以手填「联系人 Mixin ID」。删除一张卡片,它会从所有页面和课程主讲中一起消失。 ## 点击卡片会发生什么 成员点卡片时,按下面的顺序找动作,**前面的留空才轮到后面**: 1. **详情页内容** —— 打开卡片的详情页; 2. **绑定成员 / 联系人 Mixin ID** —— 唤起 Mixin 联系人名片; 3. **外链地址** —— 打开外部链接; 4. 都没填 —— 点击没有反应。 按钮文案留空就用样式的默认文案(人物「查看主页」、群组「联系助理」)。 ## 页面的其他配置 - **排列方式** —— 网格(两列)或列表(单列),右侧手机里切换就能看到差别; - **副标题 / 顶部说明条 / 底部说明条** —— 页面标题下、卡片前、卡片后的小字; - **排序** —— 多个页面在控制台列表里的先后。 ## 别忘了底部导航 页面创建好只是第一步,还要在「设置 → 外观 → [布局定制](/creator-guide/customize-trading-hub)」里把它固定到底部导航: - 中间槽位最多三个,槽位文案留空就显示页面标题; - 删除页面,指向它的标签页会一起消失; - 不想占用槽位也有别的入口:[首页入口](/creator-guide/home-entries)卡片可以直接跳转展示页面,填页面的数字 ID 即可。 ## 常见困惑 - **建了卡片,页面上没有?** 卡片的展示标签和页面的筛选标签没有任何交集。给卡片加上页面正在用的那个标签。 - **成员说找不到页面?** 页面没有固定到底部导航。去布局定制里给它一个槽位。 - **想让一张卡片出现在好几个页面?** 给它多个展示标签,或者让几个页面共用同一个筛选标签。 - **胜率能填 120 吗?** 不能,只接受 0–100 的数字。 交易大厅布局本身需要[圈子 VIP](/reference/pricing-and-fees)。 ## 相关页面 - [定制交易大厅](/creator-guide/customize-trading-hub) - [首页入口](/creator-guide/home-entries) - [选择你的布局](/creator-guide/choosing-your-layout) - [四种布局导览(成员视角)](/member-guide/layouts) --- #### 幸运活动:红包、抽奖与问答 > 用 Oh My Luck 创建营销活动 —— 资金、受众、口令与结算全流程。 > > Source: https://docs.ohmy.xin/creator-guide/luck-campaigns/ 活动是圈子的获客与活跃引擎:红包、可验证抽奖、答题、任务 · 关注 X。创建入口:控制台 → 收入 → 活动(会跳转到 Oh My Luck 创建页),或在 Oh My Luck 网页的「创建」页直接发起。 ## 创建一个活动 - **身份与可见性** —— 以个人或圈子身份发布;可选择同时展示在公开发现页。 - **四种类型** —— 红包(金额与个数、拼手气或均分、信封款式、祝福语、开启时间)、可验证抽奖(奖池、中奖人数、报名截止与开奖时间)、答题(题目、满分与排名份额)、任务 · 关注 X(目标账号、目标增长、截止时间与奖池)。 - **受众** —— 所有人、仅新人(24 小时内首次加入)、[按火花](/creator-guide/spark-points)、Rewards 受邀者(领取范围按发布时定格的[指定邀请人名单](/creator-guide/insights-and-growth)判定)。 - **口令保护** —— 红包可设 4–16 位口令,答对才能领。 - **资金** —— 创建时一笔支付覆盖奖池与服务费(活动当前 0% 平台服务费),资金由 Oh My Luck 钱包托管,被领取前随时可退。 ## 结算与退款 下面可以直接试:发一个红包、开一次签、结算一场答题。每个数字都和应用用的是同一套算法。 - **红包** —— 开启后 24 小时结束,没领完的自动退回;**仅新人红包不过期**,一直有效到你手动停止(余额退回)。 - **可验证抽奖** —— 由定时任务在开奖时间自动开奖(公开信标),不能手动结算。整个奖池在中签者之间平分,所以参与人数少于中签名额时,每个参与者都中签;没人参与则抽奖取消、奖池退回。 - **答题** —— 结束后由你(或圈子管理员)点 **结算**。全对奖励在所有全对的人之间平分,前 N 名奖励在得分最高的 N 人之间平分(同分先提交者优先),分不完的退回给你。 - **任务 · 关注 X** —— 截止后你在 24 小时内上传截图确认成功或失败;超时未处理自动按成功结算。成功时奖池在报名者中均分,失败则全额退回。 运行中的活动不能取消;未运行的可取消退款。 ## 风控与权限 - **新人领取保护**(收入 → 活动与红包风控):限制每个 IP 的领取次数与统计窗口(默认 7 天),自动封禁滥用 IP。 - **红包金额**:奖池只需保证每个红包至少 0.00000001,真正的下限是领的人觉得值不值得点开。 - **活动创建权限**(收入 → 活动创建权限):按角色开启「可创建」与「可公开发布」。 ## 相关页面 - [红包、抽奖与问答(成员视角)](/member-guide/luck) - [资金:订单与提现](/creator-guide/money-orders-payouts) --- #### 开始之前:费用与准备 > 创建圈子要花多少钱、要准备什么 —— 先算清这笔账。 > > Source: https://docs.ohmy.xin/creator-guide/before-you-begin/ 创建与运行圈子本身**免费**。你实际会遇到的开销只有两类,都在明面上。 ## 平台怎么收费 - **会员与成员档位订单:平台收 10% 服务费** —— 成员每付一笔会员费或档位费,平台从中收取 10%,其余归你。如果开启了邀请奖励,邀请人按你设定的比例从订单中分成。 - **红包、抽奖等幸运活动:0 平台服务费** —— 活动资金全部归参与者。 - **圈子 VIP:可选** —— 高级布局、视频帖子等功能按月付费(支持 1/3/12 个月预付),价格见 [定价与费用一览](/reference/pricing-and-fees)。 ## 收入怎么到你手里 成员每付一笔,平台立即把你的净收入(订单金额 − 10% 服务费 − 邀请奖励)以 Mixin 转账直接转入你的 Mixin 钱包,通常几秒到几分钟到账 —— 无需提现。详见 [圈主的收入与到账](/mixin-basics/owner-payouts)。 ## 开始前要准备什么 - 一个 Mixin 账号。 - 约 30 分钟:创建机器人、完成接入、做基础设置。 - 一个安全的地方存放机器人密钥文件 —— 接入时需要上传。 - 想好圈子的定位:给谁看、收不收费、定什么价(可后续随时调整)。 ## 相关页面 - [在 Mixin 创建机器人](/creator-guide/create-your-bot) - [定价与费用一览](/reference/pricing-and-fees) - [新手?选择你的路径](/start-here/pick-your-path) --- #### 成员与角色 > 角色阶梯、名额、批量操作与成员数据导出。 > > Source: https://docs.ohmy.xin/creator-guide/members-and-roles/ 控制台 → **成员** 是圈子的人事系统:成员列表、角色管理、会员赠送与数据导出。 ## 角色阶梯 | 角色 | 能做什么 | | --- | --- | | 所有者 Owner | 全部权限:凭证、布局、转让(每圈一人) | | 管理员 Admin | 控制台日常操作:待处理、内容、成员、设置 | | 讲师 Lecturer | 发言直达全员(讲座 / 广播)、创建付费内容、在圈主授权的频道发帖 | | 会员 Member | 看会员内容、聊天、参与活动 | | 关注者 Follower | 免费关注、只看公开内容 | | 已过期 Expired | 会员到期后的状态,续费即恢复 | | 已封禁 Blocked | 无法访问圈子 | 管理员与讲师各有 **10 个名额**。 ## 改角色与续期 成员列表里可以搜索(名称 / Mixin ID / UUID)、按角色筛选、按加入时间 / 最近活跃 / 火花排序。对单个成员或批量: - **设为管理员 / 讲师 / 会员** —— 提升为管理组时注意名额上限。 - **续期会员** —— 直接延长会员有效期,时长可选(最长 100 年,常用「永久」表达不过期)。 - **关闭限时消息** —— 对设置了 disappearing messages 的成员批量关闭与圈子的会话限制。 - **拉黑 / 解封** —— 拉黑会同时撤回其撤回窗口内的消息,见 [内容审核](/creator-guide/moderation)。 [Screenshot: 控制台成员页] ## 导出成员数据 工具栏 **导出 CSV** 生成完整名单:成员、Mixin ID 与 UUID、角色、会员到期时间、加入时间、最近活跃、最近 IP、邀请人。可用于外部 CRM 或对账。 ## 邀请相关配置 - **邀请奖励比例** 在 设置 → 入圈与价格(见 [会员与定价](/creator-guide/membership-and-pricing))。 - **Mixin 返佣**(成员 → Mixin 返佣,需开通 Mixin Rewards)—— 指定哪些成员的邀请码在本圈生效:邀请人从受邀者的 Mixin 交易获得返佣,受邀者可领「Rewards 受邀者」红包、解锁邀请码锁定的内容,见 [数据与增长](/creator-guide/insights-and-growth)。 - **邀请推广文案** —— 邀请卡片上的自定义文案,在上线清单中配置。 ## 相关页面 - [内容审核](/creator-guide/moderation) - [资金:订单与提现](/creator-guide/money-orders-payouts) --- #### 接入 OhMy.xin > 拖入 keystore.json、粘贴 Client Secret、点启动机器人 —— 剩下的 OhMy.xin 自动配置。 > > Source: https://docs.ohmy.xin/creator-guide/connect-to-ohmyxin/ 手里有 `keystore.json` 和 Client Secret 了?那这一步大约两分钟。还没有的话,先看 [在 Mixin 创建机器人](/creator-guide/create-your-bot)。 ## 步骤 下面的演示从 OhMy.xin 这半段开始;点前面的步骤可以回看每样东西是从哪来的。 > **不用再回 Mixin 改设置** > 你在 Mixin 上填的 Home URL 和 OAuth URL 只是占位。自动配置时,OhMy.xin 会替你把真正的主页地址、OAuth 回调和资源匹配规则写进机器人。 > [Screenshot: 真实向导的第 2 步。] ## 一个机器人只能接一个圈子 如果这台机器人曾被其他圈子接入,需要先在原圈子断开连接,才能接入新圈子。断开不影响机器人在 Mixin 侧的存在,重新接入即可恢复。 ## 如果出了问题
「JSON 无效 — 请粘贴完整的 keystore.json 内容」 只粘贴了文件的一部分,或者把别的东西(常见是 Client Secret)粘进了 keystore 框。最省事的做法:点 **选择文件** 直接选 `keystore.json`,不要手动粘贴。若要粘贴,从第一个 `{` 复制到最后一个 `}`。
「缺少字段:app_id, session_private_key, …」 这是旧式会话生成的文件,字段名不同。回到 developers.mixin.one,在 **Secret → App Session** 点 **Generate a new key**,用新文件即可。
点启动机器人后提示凭证错误 keystore 和 secret 不是一对,或者其中一个后来又重新生成过。确认两者来自同一个机器人,并且都用 **最新** 的那一份。
「自动配置需要重试」 机器人已经保存好了,只是 Mixin 资料更新没完成,通常是 Mixin 暂时连不上。点 **重试自动配置** 即可,不需要回 developers.mixin.one 改任何东西,重试是安全的。
## 相关页面 - [在 Mixin 创建机器人](/creator-guide/create-your-bot) - [上线清单](/creator-guide/launch-checklist) - [机器人:圈子如何运作](/mixin-basics/bots) --- #### 数据与增长 > 统计面板、今日走势、加入高峰与邀请增长工具。 > > Source: https://docs.ohmy.xin/creator-guide/insights-and-growth/ 控制台 → **数据** → 统计数据是圈子的仪表盘;**今日** 页的走势则给你最关键的短期趋势。 ## 统计数据 时间范围可选 7 / 30 / 90 天,五个维度: - **成员** —— 增长、流失与留存。 - **活跃度** —— 日活、周活、月活。 - **内容** —— 帖子、文章、资讯、评论与消息量。 - **收入** —— 订单收入、红包与打赏流水(付费圈子)。 - **邀请与增长** —— 邀请转化。 [Screenshot: 控制台「数据统计」看板] 概览磁贴包括总成员数、留存率、平均日活、总收入、平均订单金额、红包金额与邀请转化;还有成员活跃 / 贡献 / 消费排行榜和队列留存表。每个区块可单独下载 CSV,也可一键导出全部。 ## 今日走势与加入高峰 **今日** 页展示近 14 天的成员、日活、新增与收入,并和前 7 天对比给出趋势。24 小时内新增达到 5 人时会触发「加入高峰」探测 —— 去看是哪条渠道带来了增长。 ## 增长工具箱 - **邀请推广**(成员 → 邀请推广)—— 自定义邀请文案(≤500 字)与应用卡片标题(≤36 字)和描述(≤1024 字),让每次转发都带上你的卖点。 - **邀请奖励** —— 在 [会员与定价](/creator-guide/membership-and-pricing) 里设置邀请人分成比例;想把「Rewards 受邀者」红包发给指定邀请人带来的成员,用下面的 Mixin 返佣(返佣由 Mixin 从受邀者的交易中结算,与平台的邀请分成互不相干)。 - **被发现** —— 设置 → 可见性:把圈子设为公开并开启预览浏览,新访客就能在发现页浏览到你的公开内容。 - **活动拉新** —— [幸运活动](/creator-guide/luck-campaigns) 的仅新人受众就是为转化新成员设计的。 ## Mixin 返佣 **成员 → Mixin 返佣**,需平台已开通 Mixin Rewards;未开通时该入口不会出现在成员菜单中。Mixin Rewards 是 Mixin 的邀请返佣计划:成员在那里绑定某人的邀请码后,邀请人从此成员的 Mixin 交易中获得返佣。本页指定哪些成员的邀请码在本圈生效——名单里的成员充当本圈**邀请人**,凡被他们通过 Mixin Rewards 邀请来的成员(受邀者)获得两类资格。 ### 领「Rewards 受邀者」红包 [幸运活动](/creator-guide/luck-campaigns) 里受众为「Rewards 受邀者」的红包,只有受邀者能领: - 名单内邀请人邀请来的成员都可以领取;被红包创建者邀请来的成员始终可领。 - **留空就是默认行为** —— 只有红包创建者邀请来的成员可领。 - **名单在红包发布时定格** —— 付款发布那一刻的名单被冻结进红包,之后的改动只对之后发布的红包生效;空名单时发布的红包,事后补邀请人也不会放开。 ### 解锁「邀请码解锁」的内容 帖子、策略与文章发布时可把可见性设为「邀请码解锁」(编辑器里的 可见性:公开 / 邀请码解锁)。锁定后: - 全文只对名单内邀请人邀请来的成员开放;圈内管理员与讲师始终可见。 - **名单为空时,锁定内容仅管理员与讲师可见** —— 想用锁定帖拉新,先指定邀请人。 - 成员在锁定封面上点「绑定邀请码」前往 Mixin Rewards 绑定邀请人的邀请码,绑定后回到封面点「已绑定?重新检测」即可解锁。 - 同页的 **绑定邀请码链接** 决定「绑定邀请码」按钮跳转哪里:默认是 Mixin Rewards 官方指引,可覆盖为 `https://` 地址或站内路径。 ### 维护名单 - 添加时按姓名、Mixin ID 或 Mixin UUID 搜索;被拉黑和关注者角色的成员不可添加。 - 成员退圈后名单里会标注「已不再是本圈成员」,资格仍以 Mixin Rewards 记录的邀请人 UUID 为准。 ## 相关页面 - [资金:订单与提现](/creator-guide/money-orders-payouts) - [幸运活动:红包、抽奖与问答](/creator-guide/luck-campaigns) --- #### 欢迎体验设置 > 新成员进圈第一眼看到的一切 —— 欢迎卡、介绍、社群指南与自动入圈。 > > Source: https://docs.ohmy.xin/creator-guide/welcome-experience/ 设置路径:控制台 → 设置 → 欢迎与引导。这里决定新成员加入后收到什么。 ## 三个基础件 - **欢迎语** —— 成员加入时发送一次的私信欢迎卡。 - **介绍卡片** —— 圈子是做什么的、规则是什么,新成员入圈即可见。 - **社群指南** —— 更完整的使用说明,可分别维护中文版与英文版。 [Screenshot: 控制台设置中的「欢迎与引导」分区] 欢迎卡有一个**主按钮**(默认「打开圈子」,直达圈子首页)和一组**网格按钮**(文案 ≤20 字,主按钮与网格合计 ≤18 个)。每个按钮二选一:**链接**(`https://…` 外部页面,或 `/` 开头的圈子页面)或**发送文本**(以成员身份发出指定文字 —— 命中自动回复的触发词就能接出下一层,见 [实战手册:新手引导](/playbooks/bot-onboarding))。配置后可用预览功能发到自己的 Mixin 里检查效果。介绍卡片(访客所见)也有同样的按钮配置。 链接按钮指向**新的外部域名**时,保存会弹一个确认框:Mixin Messenger 只打开已列入机器人资料白名单的域名的卡片按钮,确认后平台会把这些域名加入白名单再保存。这是 Mixin 的安全机制,不用手动操作。 同一分区的下方还有 **封面** —— 帖子被分享到 Mixin 时的应用卡片封面图(≤5 MB)。 ## 自动入圈 免费圈子可开启「首条消息自动入圈」:用户给机器人发消息即自动成为成员,省去点击加入的一步。社区大厅布局下此选项强制关闭。 ## 新成员会收到什么 成员加入时,按你的配置依次送达:欢迎卡 → [入门精选](/creator-guide/content-toolkit)(资讯中心布局,最多三个精选资讯源卡片)→ 新人红包(如果你发布了仅新人可领的红包)→ 群聊模式下还会收到一条快速的近期内容回顾。 ## 如果出了问题 - **欢迎卡没发出去** —— 确认欢迎语已保存;欢迎语只在成员加入时发送一次,改文案不影响已加入的成员。 - **按钮点不开** —— 链接按钮检查地址是否完整(`https://` 开头,或 `/` 开头的圈内路径),外链域名必须在保存时的白名单确认里加入过;发送文本按钮检查要发送的文字是否已填写。 ## 相关页面 - [上线清单](/creator-guide/launch-checklist) - [实战手册:机器人新手引导](/playbooks/bot-onboarding) - [会员与定价](/creator-guide/membership-and-pricing) --- #### 消息模板与主动推送 > 创建可复用的消息模板,向圈子成员或指定角色发送通知。 > > Source: https://docs.ohmy.xin/creator-guide/message-templates-and-broadcasts/ 消息模板让你把常用内容保存起来,用于欢迎卡、介绍卡、自动回复或主动推送。圈主和管理员可以通过主动推送发送活动提醒、课程通知等消息。 ## 创建消息模板 1. 打开 **控制台 → 群聊 → 消息模板**,选择 **新建模板**。 2. 填写模板名称,选择消息类型:文本、长文(帖子)、联系人名片或应用卡片。 3. 编辑内容并查看预览。应用卡片可以设置标题、封面、描述和按钮;按钮可打开链接或发送文本,也可以调整顺序。 4. 保存模板。以后可以编辑、复制或删除,也可以发到自己的 Mixin 中预览。 模板属于当前圈子。在欢迎卡、介绍卡或自动回复编辑器中,选择 **使用模板** 可将适用的模板内容填入编辑器;检查并保存该页面后才会生效。也可以先保存这些页面的内容,再选择 **另存为模板**。复制后的内容独立保存:之后修改或删除模板,不会改变已经保存的卡片、自动回复或推送记录。 ## 发起主动推送 1. 在 **控制台 → 群聊 → 主动推送** 选择 **新建推送**。也可以从模板库选择推送某个模板。 2. 选择本圈子的消息模板,再选择接收人。**全体成员**包括圈主、管理员、嘉宾和成员;也可按角色选择,包括关注者和过期成员。 3. 检查页面显示的预计人数,并使用 **发给我测试** 在自己的 Mixin 中检查内容。测试不会创建推送记录。 4. 选择 **立即推送** 并确认。确认时会确定内容和接收人,发出后无法修改。 5. 在推送详情查看状态、人数和失败原因。 关闭了圈子消息的用户不会收到推送;如果圈子开启了不活跃成员消息暂停,处于暂停状态的用户也不会收到。接收人数以确认时的名单为准。 ## 查看结果、停止或撤回 详情页显示目标人数、已发送、失败、未发送、送达和已读。**送达和已读只统计 Mixin 客户端回报的人数,实际人数可能更多**;页面只显示汇总,不显示每位成员的已读情况。未送出列表可查看失败原因。 推送进行中可以选择 **停止推送**;已经进入发送队列的消息仍可能送达。推送结束后,在允许的时间内可选择 **撤回**,向已发送的接收人发起撤回;撤回由后台处理,可能被 Mixin 拒绝。 主动推送是一次性发送,与[聊天模式中的广播](/creator-guide/chat-modes-for-owners)是不同功能。更多设置方法参见[聊天模式与自动回复](/creator-guide/chat-modes-for-owners)和[欢迎体验设置](/creator-guide/welcome-experience)。 --- #### 生命周期:休眠、重连与转让 > 圈子太久不活跃会怎样、凭证怎么重连、圈主怎么转让与退出。 > > Source: https://docs.ohmy.xin/creator-guide/lifecycle/ ## 休眠与唤醒 圈子连续 **30 天** 没有活动,管理组会先收到提醒(休眠前 3 天起,最多三次),到期后机器人离线、圈子进入休眠: - 成员打开休眠的圈子,会被提示联系圈主。 - 所有者或管理员打开圈子或控制台时会看到 **唤醒** 按钮,点一下机器人很快重新连线。 - 休眠的机器人不再接收消息;[续费 VIP](/creator-guide/circle-vip) 会自动解除休眠,VIP 有效的圈子不会休眠。 ## 断开与重连 设置 → 机器人连接(或机器人设置页): - **断开** —— 暂停与 Mixin 网络的连接,消息投递停止;随时可重连。 - **重连** —— 校验通过后恢复。注意:**只能重连同一个 Mixin 机器人**(client ID);想换机器人只能删除圈子重建(一个机器人对应一个圈子)。 - **轮换凭证** —— 需先断开;重连需输入圈子编号确认,防止误操作。 ## 圈主转让 设置 → 危险操作 → 转让圈主(仅圈主可操作): 1. 填写目标成员的 Mixin ID,勾选确认。 2. 立即生效,无需对方接受:对方成为圈主(收入与提现自此进入其钱包),你变为管理员,控制台权限不变。 3. 双方都会收到私信通知,操作记入变更记录。 转让不可由管理员代操作;请确认对方 Mixin ID 无误。 ## 删除圈子 在机器人设置页的危险操作里删除:需先断开机器人;删除后圈子数据移除、存储的机器人凭证清空。删除不可恢复,想暂停就用断开或让它自然休眠。 ## 相关页面 - [圈子 VIP](/creator-guide/circle-vip) - [设置参考](/creator-guide/settings-reference) --- #### 积分火花 > 成员互动怎么计分、等级怎么升、红包怎么按火花限领 —— 激励系统的全部规则与开关。 > > Source: https://docs.ohmy.xin/creator-guide/spark-points/ 火花是鼓励成员持续参与的积分系统,默认开启,无需配置即可运转。成员只能看到自己的积分,没有公开排行榜。 ## 积分怎么来 | 行为 | 每次 | 每日上限 | | --- | --- | --- | | 阅读帖子 / 文章 / 资讯 | 1 | 3 | | 点赞或投票 | 1 | 3 | | 评论 | 2 | 3 | | 发帖 | 3 | 2 | | 发送群聊消息 | 1 | 3 | - 所有行为合计,每天最多计分 **10 次**有效行为。 - 阅读要在页面上可见停留约 5 秒才计分;同一篇内容 90 天内不重复计分。 - 聊天消息是否计分可以单独关闭(见下文开关),适合只想为阅读、点赞、评论、发帖计分的圈子。机器人与系统消息永远不计分。 ## 连续与等级 - 每天第一次有效行为会延续**连续天数**,并额外获得等于连续天数的积分加成(封顶 7)。漏了一天,连续清零重来;累计积分与等级不受影响。 - 累计积分点亮五级王冠,成员在「我的」页看到自己的总量、连续与等级: | 等级 | 名称 | 所需累计积分 | | --- | --- | --- | | 1 | 余烬 | 0 | | 2 | 星火 | 40 | | 3 | 火焰 | 150 | | 4 | 烈焰 | 500 | | 5 | 灯塔 | 1200 | ## 圈主能配置什么 设置 → **积分火花** 区块只有两个开关,页面上各带一段说明文字: - **第一个开关**管理整个积分系统 —— 「开启后,成员可从圈内活动获得积分;总量、连续与等级显示在『我的』页面。关闭后暂停获得,已有积分会保留。」默认开启。 - **第二个开关**决定聊天消息是否计分 —— 「是否把普通聊天消息计入积分(默认开启)。若只想从阅读、互动、评论、发帖计分,可关闭。」 另一个用到火花的地方是 [幸运活动](/creator-guide/luck-campaigns):红包可以把受众设为「按火花」,只有达到所选等级及以上的成员才能领取 —— 给活跃老成员的专属福利。 ## 在这里试一遍 下面的控制台还原了你能配置的全部三处:两个开关、红包受众。右侧是一份样例成员名单(累计积分各不相同),改动任意设置,谁能领红包、聊天还计不计分,立刻反映在名单和计分预览上。 积分不能消费、转账或兑付,只用于记录参与和解锁等级。 ## 相关页面 - [幸运活动:红包、抽奖与问答](/creator-guide/luck-campaigns) - [成员与角色](/creator-guide/members-and-roles) - [设置参考](/creator-guide/settings-reference) --- #### 聊天模式与自动回复 > 选对消息模式,配好自动回复与消息过滤,管好圈子对话。 > > Source: https://docs.ohmy.xin/creator-guide/chat-modes-for-owners/ **聊天模式决定了谁能听到谁。** 选一个模式,发几条消息,看看每条消息到了谁的手机上。 > **该选哪个模式?** > - 一对一私密答疑 → **静默模式** > - 你来发,大家看 → **广播模式** > - 直播讲课,结束后留回放 → **讲座模式** > - 大家一起聊 → **群聊模式** **VIP** > ## 谁能看到什么 | 模式 | 你直接发消息 | 你引用回复某位成员 | 成员发消息 | | --- | --- | --- | --- | | 静默 | 不会送出 —— 机器人会提醒你引用回复 | 只有该成员 | 你和管理组 | | 广播 | 全员 | 只有该成员 | 你和管理组 | | 讲座 | 全员,并录入回放 | 只有该成员 | 你和管理组(仅在开放问答时) | | 群聊 | 全员 | 全员 | 全员 | 表中的「你」也包括管理员和讲师 —— 他们发消息的覆盖范围和圈主一样。 在 **Oh My Live 直播间**里,聊天遵循同一套模式:成员看到的范围与圈子聊天一致,不能发言时输入框会说明原因。圈主和管理员可以在房间内直接切换模式,切换后所有正在进行的房间会自动刷新聊天。 ## 切换模式 - 路径:**控制台 → 设置 → 群聊规则**;也可以给机器人发 `/help` 快速切换。 - 每次切换,订阅了消息的成员都会收到机器人私信通知。 - 切换到**讲座模式**需要二次确认,因为会立即开始录制。问答默认关闭:发 `/qa on` 开放提问,`/qa off` 关闭。结束时自动生成回放帖。 - **广播模式**下,前一天的广播会自动整理成回放。 - **群聊模式**需要[圈子 VIP](/reference/pricing-and-fees);VIP 到期后,圈子会自动退回广播模式。 ## 自动回复 **控制台 → 群聊 → 自动回复**:设置触发关键词和机器人的回复 —— 文本、长文(帖子)、联系人名片,或带封面、标题和按钮的应用卡片。 - 新成员发「入门」→ 机器人回复你的指南帖。 - 有人发「课程」→ 机器人回复带购买链接的卡片。 - 触发词精确匹配成员消息(一条规则可配多个,逗号分隔);同一触发词配了多条规则时,**先创建的生效**。 - 应用卡片的按钮分**链接**与**发送文本**两种 —— 发送文本会以成员身份发出该文字,正好命中你设置的触发词,可以拼出多层引导,见 [实战手册:机器人新手引导](/playbooks/bot-onboarding)。 - 每条规则都可以在页面上试运行,或发送到自己的 Mixin 预览。 > **caution** > 触发词如果和平台命令重名(如 `/help`),会在你的圈子里覆盖该命令。控制台会明确提示。 > ## 管理回放 讲座与广播的回放集中在 **控制台 → 群聊 → 回放**。回放生成后默认**只有你可见**:先在这里给它起个正经标题(默认按日期生成),整理好再切换为对成员可见,它就会出现在圈子页的回放列表里。列表显示每场回放的消息数与平均听众数,帮你判断哪场更受欢迎;改主意了随时重新隐藏。 ## 消息过滤与频率 在**设置 → 群聊规则**里: - **消息冷却时间** —— 同一成员两条消息之间的最小间隔秒数(120 = 每两分钟一条;设 0 关闭)。 - **内容过滤** —— 自动拦截链接、图片、语音或卡片消息。 ## 相关页面 - [内容审核](/creator-guide/moderation) - [视频直播(Oh My Live)](/creator-guide/live-streams) - [实战手册:机器人新手引导](/playbooks/bot-onboarding) - [欢迎体验设置](/creator-guide/welcome-experience) --- #### 视频直播(Oh My Live) > 开播、观众范围、推流、直播间互动与回放 —— Oh My Live 的完整操作。 > > Source: https://docs.ohmy.xin/creator-guide/live-streams/ Oh My Live 是[圈子 VIP](/creator-guide/circle-vip) 的视频直播:圈主和管理员用 OBS 或手机推流,成员在圈子里或直播间观看,结束后可以留下回放。入口:**控制台 → 内容 → 直播**。 > **先确认已经开通** > 直播需要平台为你的圈子开通,并且圈子 VIP 在有效期内。未开通时控制台不会出现「直播」入口;VIP 不可用时,直播页只显示升级提示。 > ## 开播前 - **谁能开播** —— 圈主和管理员。 - **观众范围**: - **仅成员** —— 只有圈子成员能看到并加入。 - **在 Oh My Live 展示** —— 标题和圈子会出现在公开的 `/live` 目录;观看仍需先加入圈子。 - **标题、简介与封面** —— 封面 16:9,PNG/JPG,不超过 5 MB。 - **开播时间** —— 立即开播,或预约(最多提前 30 天)。 - **录制** —— 可以录制并发布回放,并决定是否向成员展示回放。 - **预告** —— 预约直播可以勾选按计划时间向订阅者发送预告;成员也可以自己设开播提醒。 ## 推流与开播 1. 新建直播并保存,在「推流」里拿到**服务器**与推流密钥。 2. 把两者填进 OBS 或手机推流 App(Larix、Prism)。 3. 推荐 H.264 + AAC、CBR 单码率:720p30 用 2500–4000 kbps,关键帧间隔 2 秒、关闭 B 帧,音频 128 kbps / 48 kHz。 4. 编码器开始推流后,「开始直播」才会点亮;推流中断会进入重连宽限期,恢复推流后直播自动继续。 5. 点「结束」后直播结束,成员无法继续观看。 > **caution** > 推流密钥有有效期。更换密钥会让当前编码器配置立即失效,需要重新填写。 > ## 直播台 控制台 → 内容 → 直播提供三个标签页: - **当前与预告**:正在直播的场次、录制状态、时长与观众数;以及已排期的预告与设提醒人数。 - **往期**:每场的时长、峰值观众、通过直播加入的新成员与回放状态。 - **用量**:本月直播分钟数与配额。用到 90% 会提醒;配额用完后直播自动结束。平台可以为单个圈子覆盖配额。 同一个圈子同时只能有一场直播。 ## 直播间与互动 - 成员从圈子聊天里的直播卡片、圈子主页的直播条,或 `/live` 目录进入房间。 - 房间聊天与圈子聊天同步,并沿用当前[聊天模式](/creator-guide/chat-modes-for-owners):成员看到什么、能不能发言都由模式决定。 - 圈主和管理员可以在房间内直接切换模式;切换后所有进行中的房间会自动刷新聊天。 - 停播时房间会隐藏观众数与输入框。 ### 在房间里试一遍 下面的演示从**成员视角**还原直播间。用右侧的「主播面板」切换模式、开个问答——注意两点:切换后成员房间里的聊天提示会立刻刷新;静默模式下连「主播发言」都进不了聊天,要切换到广播或讲座才能向所有人说话。 ## 回放 - 开启录制后,直播结束会生成回放,进入圈子的回放列表。 - 可以控制回放是否向成员展示;回放页沿用直播间的外观,并按录制分段标记。 ## 如果出了问题 - **控制台没有「直播」** —— 平台还没有为圈子开通,或圈子 VIP 不在有效期。 - **「开始直播」是灰的** —— 编码器还没有开始推流。 - **直播突然结束** —— 可能用完了本月分钟配额,或推流中断超过宽限期。 - **成员找不到直播** —— 检查观众范围;选「仅成员」时,只有已加入圈子的成员能看到。 ## 相关页面 - [圈子 VIP](/creator-guide/circle-vip) - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) - [内容工具箱](/creator-guide/content-toolkit) - [定价与费用一览](/reference/pricing-and-fees) --- #### 设置参考 > 设置页每一个区块、每一个字段的速查手册,以及暂存发布与撤销机制。 > > Source: https://docs.ohmy.xin/creator-guide/settings-reference/ 控制台 → **设置** 一页收录成员体验到的全部圈子设置。顶部还有两张卡:机器人连接与危险操作。 ## 区块速查 | 区块 | 字段 | | --- | --- | | 资料与语言 | 圈子语言(页面与机器人通知的用语) | | 外观 | 布局与布局定制([选择你的布局](/creator-guide/choosing-your-layout)、[定制资讯中心](/creator-guide/customize-story-hub)、[定制交易大厅](/creator-guide/customize-trading-hub)、[首页入口](/creator-guide/home-entries));帖子卡片可分享;帖子标签(≤20 个);交易入口与类型(交易大厅) | | 入圈与价格 | 谁可以加入;收费币种;入圈价格;计费周期;会员时长;续费折扣(0–99%);邀请奖励;定价方式;试用天数(0–365) | | 可见性 | 圈子公开 / 私密;浏览模式(预览需付费圈子);帖子与文章可见范围 | | 欢迎与引导 | 欢迎语;介绍卡片;欢迎卡按钮(主按钮 + 网格按钮合计 ≤18,文案 ≤20 字,链接或发送文本);首条消息自动入圈;跳过联系人问候;社群指南(中英双语) | | 公告与客服 | 公告开关与内容(≤200 字);客服联系人 | | 群聊规则 | 消息冷却时间(秒);链接 / 图片 / 语音 / 卡片过滤 | | 积分火花 | 积分系统开关;聊天消息是否计分(见[积分火花](/creator-guide/spark-points)) | | 防骚扰 | 防护开关;强度;链接策略;新成员消息阈值;退出跨圈扫描 | | 成员策略 | 不活跃提醒(7–365 天,0 关闭);匿名模式;管理员可见真实身份;隐藏成员数与成员列表 | | 内容与发帖 | 谁可以发帖;是否允许提问 | 「隐藏成员数」会同时隐藏成员列表:成员与访客只看到管理团队,圈主和管理员始终看到完整列表。 另有 **机器人资料** 卡片:机器人在 Mixin 里的显示名称(≤36 字)、简介(≤512 字)与头像(≤512 KB)。红包风控、邀请推广、活动创建权限等在各自的专属页面,不在这张表里。 [Screenshot: 设置页的「机器人资料」卡片:已连接机器人的头像、名称与简介编辑表单] 机器人连接后才显示这张表单;未连接时这里只有一条提示和「去连接」按钮。保存后名称、简介与头像会同步到 Mixin 里的机器人资料。 ## 暂存发布与撤销 - 修改先暂存:页面会显示未保存项数,点 **确认更改** 后逐字段展示影响(如改价会引用近 7 天的续费数据),确认才发布。 - **管理员修改涉及费用与权限的设置时必须填写原因**,原因会记录并同步给圈主(圈主本人修改无需填写)。 - 所有变更写入 **变更记录**:设置发布类操作支持一键撤销(若字段后来又被改过,撤销会提示已漂移)。 ## 在这里试一遍 区块速查表适合查阅,而「暂存发布与撤销」适合动手走一遍:改字段 → 看逐字段影响 → 管理员身份触发原因必填 → 发布进变更记录 → 撤销与漂移警告。 ## 相关页面 - [会员与定价](/creator-guide/membership-and-pricing) - [内容审核](/creator-guide/moderation) --- #### 资讯源管理 > 订阅外部内容源,自动搬进圈子 —— 资讯源的添加、设置与发布队列。 > > Source: https://docs.ohmy.xin/creator-guide/story-feeds-and-sources/ 资讯源是 [资讯中心布局](/creator-guide/choosing-your-layout) 的核心:把外部内容(X、YouTube、Telegram、Discord、哔哩哔哩、微博、GitHub、Hacker News、知乎、Medium 等)持续搬进你的圈子。属 [圈子 VIP](/creator-guide/circle-vip) 功能。 ## 添加资讯源 控制台 → 内容 → 资讯源 → 添加,三步向导: 1. 选分类(社交、交易信号、视频直播、文章资讯等)。 2. 选来源 —— 从平台维护的来源目录中挑选(也可直接粘贴主页或频道链接自动识别),不同来源的抓取频率不同(如 X 用户时间线约 2 分钟,视频源约 1 小时)。 3. 预览最近的内容,确认后点 **添加到圈子**。 ## 每个源的设置 - **自动发布** —— 开启时内容直接进时间线;关闭时先存草稿,进入 [待处理](/creator-guide/moderation) 的「待发布的内容」由你逐条确认。 - **新资讯通知成员** —— 把新内容推送给订阅了该源的成员(仅资讯中心以外的布局显示)。 - **可见级别** —— 公开 / 试用 / 仅会员。 - **展示信息** —— 名称(≤120 字)、简介(≤2000 字)、标签(最多 5 个 ×20 字)、图标(≤5 MB)、精选标记与排序。 - **编辑分组** —— 自定义分组名,把源归拢成成员易浏览的栏目。 ## 日常维护 - 每个源可手动 **拉取**(5 分钟冷却);抓取持续失败的源会出现在待处理的「来源抓取失败」里。 - 控制台 → 内容 → 资讯内容:发布草稿、隐藏、编辑标签、把内容发进群聊。 ## 在这里试一遍 两个演示源各拉一次:开了自动发布的直接进成员时间线,没开的进「待处理」等你在队列里点发布;拉取后进入 5 分钟冷却(用「快进 5 分钟」解除),打开「模拟持续失败」再看它出现在「来源抓取失败」里。 ## 进阶:跨圈发布 交易大厅圈子可以把本圈的帖子与策略发布为资讯源,供其他圈子订阅(「跨圈精选」「跨圈策略」),让好内容流通起来。 ## 相关页面 - [选择你的布局](/creator-guide/choosing-your-layout) - [内容审核](/creator-guide/moderation) --- #### 资金:订单与到账 > 订单从创建到完成的完整生命周期,收入怎么查、钱怎么到账。 > > Source: https://docs.ohmy.xin/creator-guide/money-orders-payouts/ 控制台 → **收入** 是资金中枢:订单列表、VIP 升级入口都在这里;**今日** 与 **数据** 页展示收入概览。 ## 订单的生命周期 1. 成员发起购买,订单进入等待支付状态,**15 分钟内有效**,超时自动过期。 2. 成员付款,金额校验通过后订单标记为已支付:会员或档位立即生效,你会收到通知。 3. 随后结算自动完成:平台收取 10% 服务费,邀请奖励(如开启)分给邀请人,其余金额通过平台的 Mixin Safe 直接转入你的 Mixin 钱包,通常几秒到几分钟内到账 —— 无需任何提现操作。[看看一笔会员或档位费怎么分 →](/reference/pricing-and-fees#每笔收入怎么分) 支付异常会被明确拒绝:付款金额不足(少付)、交易号不匹配(付错订单)、收款对象不对。这些付款不会生效,成员的钱由平台核实后原路退回。 ## 查订单 收入 → 订单:按状态筛选(已付款 / 已完成 / 已过期),按订单号、交易号、成员 Mixin ID 或名称搜索,支持最近 7 / 30 / 90 天范围。每笔订单都能用交易号对回到 Mixin 里的原始转账。 [Screenshot: 控制台订单页] ## 看收入趋势 - **今日** 页的走势:近 14 天收入与订单数。 - **数据** → 统计数据:收入图表(订单收入、红包与打赏,付费圈子可见),含 USD 折算。 ## 会员赠送 成员 → 会员赠送:为指定成员免费延长会员有效期。填写接收者、时长(月)、计算方式(自然时长或下一自然月)与原因;操作留审计记录。 ## 如果出了问题 - **订单显示已过期但成员说付了钱** —— 让成员提供交易号,在订单搜索里核对;付款与订单不匹配时订单不会生效,平台核实后会将款项原路退回给成员。 - **收入没到账** —— 每笔订单付款成功后,平台立即把货款(扣除 10% 服务费和邀请奖励)直接转入你的 Mixin 钱包,通常几秒到几分钟;超时可凭订单里的交易号在 Mixin 中查询转账状态。 ## 相关页面 - [会员与定价](/creator-guide/membership-and-pricing) - [定价与费用一览](/reference/pricing-and-fees) --- #### 选择你的布局 > 经典、资讯中心、社区大厅、交易大厅 —— 给圈子挑一个合适的门面,并知道它能定制什么。 > > Source: https://docs.ohmy.xin/creator-guide/choosing-your-layout/ 布局决定成员打开圈子看到什么。设置路径:控制台 → 设置 → 外观。只有圈主和管理员可以更改,其他管理员的视角下外观区为只读。 ## 四种布局 经典是默认布局。资讯中心与交易大厅是 [圈子 VIP](/reference/pricing-and-fees) 布局:未开通时布局卡带 VIP 徽标且不可选,升级入口就在卡上。 ## 布局轨道与切换 外观区是一条横向布局轨道:每个布局一张预览卡,当前布局排在最前。选择其他布局后点「保存布局」,控制台会弹出确认框,并列出**得失清单** —— 切换后哪些功能将可用、哪些将不可用,确认后才生效。 切换不会删除任何东西:帖子、成员、订单全部保留,**布局定制也存在圈子的布局设置里** —— 以后切回来,定制原样恢复。改变的只是功能可用性:频道仅经典布局可用,策略管理与直播课程仅交易大厅,入门精选仅资讯中心,首页入口在资讯中心 / 社区大厅 / 交易大厅三个布局可用。每次切换与每次定制都记录在变更历史里。 ## 布局定制:每个布局能改什么 每个布局卡的「布局定制」按钮打开右侧抽屉。经典与社区大厅没有定制项,会提示「当前布局没有可定制项」;两个 VIP 布局的抽屉内容各不相同: - **资讯中心**:导航标签、来源 / 资讯的叫法、首页标题 / 副标题 / 横幅,外加一个「首页入口」标签页 —— 见 [定制资讯中心](/creator-guide/customize-story-hub)。 - **交易大厅**:主页频道(顺序、启停、短名)与底部导航槽位,抽屉里还能直接管理首页入口、展示页面与展示卡片 —— 见 [定制交易大厅](/creator-guide/customize-trading-hub)、[首页入口](/creator-guide/home-entries) 与 [展示页面与展示卡片](/creator-guide/showcase-pages-cards)。 正在切换布局时,定制按钮会先禁用,提示先保存或放弃布局切换;抽屉里未保存的修改在关闭时也会先询问。 抽屉之外,外观分区还收着与布局无关的开关:帖子卡片可分享、帖子标签(≤20 个)、交易入口与类型(交易大厅)—— 见 [设置参考](/creator-guide/settings-reference)。帖子分享到 Mixin 时的应用卡片封面(≤5 MB)在 [欢迎体验](/creator-guide/welcome-experience) 里设置。 ## 相关页面 - [定制资讯中心](/creator-guide/customize-story-hub) - [定制交易大厅](/creator-guide/customize-trading-hub) - [首页入口](/creator-guide/home-entries) - [内容工具箱](/creator-guide/content-toolkit) --- #### 首页入口 > 跳转目标、隐藏条件与管理路径的完整参考 —— 首页入口属于布局定制,在资讯中心与交易大厅的定制抽屉里管理。 > > Source: https://docs.ohmy.xin/creator-guide/home-entries/ 首页入口是成员首页上的快捷卡片:每张有标题(≤80 字)、可选描述(≤500 字)、图标与排序,点开即到达圈内页面或外部网站。首页入口属于**布局定制**的一部分,在**资讯中心、社区大厅、交易大厅**三个布局可用,经典布局没有。 ## 在哪里管理 - **资讯中心与交易大厅**:布局定制抽屉的「首页入口」标签页(控制台 → 设置 → 外观 → 布局定制)。入口列表、新增、编辑与删除都在抽屉里完成,与展示页面 / 展示卡片标签页的交互一致,见 [定制资讯中心](/creator-guide/customize-story-hub) 与 [定制交易大厅](/creator-guide/customize-trading-hub)。 - **社区大厅**:没有定制抽屉,管理页是 控制台 → 内容 → 首页入口。 ## 跳转目标一览 **圈内内容** | 跳转目标 | 成员点开后 | 要填什么 | | --- | --- | --- | | 文章列表 | 圈子的全部文章 | — | | 单篇文章 | 打开这篇文章 | 文章 ID | | 文章合集 | 合集的有序阅读列表页 | 合集 ID | | 来源目录 | 资讯源目录页 | 可选:分类 slug 筛选 | | 单个资讯源 | 该资讯源的页面 | 资讯源 ID | | 新手指南 | 圈子的新手指南页 | — | 数字 ID 都能在控制台对应列表(或其页面网址)里找到。 **成员自助** | 跳转目标 | 成员点开后 | 要填什么 | | --- | --- | --- | | 订单记录 | 成员自己的订单页 | — | | 个人资料 | 个人资料页 | — | | 开通 / 续费会员 | 会员购买页 | — | | 成员目录 | 成员列表页 | — | | 提问 | 提问页 | —(未开启问答时成员看不到) | | 发红包 | 红包发送页 | —(未开启红包时成员看不到) | **机器人与外链** | 跳转目标 | 成员点开后 | 要填什么 | | --- | --- | --- | | 推荐机器人 | 友情链接的机器人列表 | 可选:标签预筛选(无可见链接时入口隐藏) | | 机器人入口 | 直达另一个 Mixin 机器人 | 从友情链接中选择 | | 外部链接 | 打开外部网站 | 完整 URL(需 https) | **组织与展示** | 跳转目标 | 成员点开后 | 要填什么 | | --- | --- | --- | | 文件夹 | 展开一组入口 | 只能放在顶级,不能嵌套 | | 展示页面 | 打开一个展示页面(仅交易大厅) | 页面数字 ID | ## 什么情况下入口不显示 入口保留在管理列表里、但对成员隐藏的情况:入口或所在文件夹被**停用**;跳转目标**还没填**或**已被删除**;提问 / 红包功能未开启;友情链接没有可见条目;外链地址为空;文件夹里没有任何可见条目。管理列表会逐条标出原因。 ## 在这里试一遍 把上面的隐藏规则走一遍:左边管理列表逐条标注「成员可见 / 隐藏原因」,右边是成员首页实时预览。停用入口、清空文章 ID 或外链地址、关掉问答或友情链接,再切换到社区大厅看文件夹的后台分组与单目标「别名」效果。 ## 用例:社区大厅 · 工具导航 社区大厅没有定制抽屉,成员首页本身就是入口卡片:顶级直接放机器人入口(价格机器人、客服机器人)与 https 外链。文件夹在社区大厅只用于后台分组,成员端只看顶级条目;只含一个目标的文件夹会直接跳转过去 —— 正好当「别名」用。 资讯中心与交易大厅的用法(新手路径、快捷通道)已分别内嵌在 [定制资讯中心](/creator-guide/customize-story-hub) 与 [定制交易大厅](/creator-guide/customize-trading-hub) 的「首页入口标签页」一节。 ## 相关页面 - [定制资讯中心](/creator-guide/customize-story-hub) - [定制交易大厅](/creator-guide/customize-trading-hub) - [选择你的布局](/creator-guide/choosing-your-layout) - [内容工具箱](/creator-guide/content-toolkit) ### Playbooks / 实战手册 #### 实战手册 > 四个完整的装修案例 —— 把圈子的功能组合起来,解决真实的运营问题。 > > Source: https://docs.ohmy.xin/playbooks/ 前面的指南按功能逐个讲;这一节反过来,**从问题出发**:想要什么样的成员体验,需要组合哪些功能、在哪里配置。每个案例都是同一套结构: - **目标** —— 这个圈子要解决什么问题; - **成员会经历什么** —— 从成员视角走一遍完整旅程; - **圈主要做的事** —— 每一步给出控制台入口与关键参数,细节链接到对应指南页; - **变体** —— 更省事的做法,或往前多走一步的玩法。 案例里的圈子与数字都是虚构的演示数据。四个案例各对应一种典型社群: - [案例一:机器人里的新手引导](/playbooks/bot-onboarding) —— 欢迎卡 + 发送文本按钮 + 自动回复,做出多层引导树(任何布局可用) - [案例二:资讯中心的新成员动线](/playbooks/newcomer-content-path) —— 入门精选、首页入口与通知栏串成一条内容路线 - [案例三:交易大厅的付费门面](/playbooks/trading-hub-storefront) —— 展示页面、频道与首页入口组成服务店面 - [案例四:社区大厅的工具站](/playbooks/community-tool-station) —— 机器人入口与外链把首页变成导航页 想先了解单个功能?回到 [创作者指南](/creator-guide/)。 --- #### 案例一:机器人里的新手引导 > 欢迎卡按钮 + 发送文本 + 自动回复触发词 —— 不写一行代码,给成员一套多层引导。 > > Source: https://docs.ohmy.xin/playbooks/bot-onboarding/ 成员加入圈子后的第一分钟,决定了他的第二分钟。这一案例用三个机器人层的能力拼出一套**多层引导**:欢迎卡的按钮、按钮的「发送文本」类型、自动回复的触发词。它在聊天里完成,与圈子用哪种布局无关。 **思路**:欢迎卡按钮除了打开链接,还可以「发送文本」—— 以成员身份发出一段文字。这段文字如果正好是某条自动回复的触发词,机器人就会接话。按钮 → 触发词 → 回复卡片 → 卡片又带按钮,一棵引导树就长出来了。 左边是控制台配置的模拟(欢迎卡按钮 + 自动回复规则),右边是成员看到的对话。勾选「规则透视」可以看到每条消息背后的规则。试试:点「新人导览」→「找内容」→「打开圈子首页」。 ## 它是怎么工作的 1. 成员入圈,机器人送上**欢迎语和欢迎卡**(设置 → 欢迎与引导)。 2. 欢迎卡有一个**主按钮**(默认「打开圈子」,链接到 `/`)和最多若干**网格按钮**。每个按钮二选一: - **链接** —— 打开 `https://…` 外部页面,或 `/` 开头的圈子页面; - **发送文本** —— 以成员身份把指定文字发进对话。 3. 发出的文字命中**自动回复的触发词**(精确匹配,区分大小写;一条规则可配多个触发词,逗号分隔),机器人回复:文本、帖子、联系人名片,或带按钮的应用卡片。 4. 应用卡片的按钮同样支持发送文本 —— 于是可以继续往下一层。同一触发词配了多条规则时,**先创建的生效**。 ## 圈主要做的四步 1. **先画树,再动手**。两层通常够用:入口按钮(2–3 个)+ 每个入口的二级菜单。给每个入口起一个触发词 —— 它会显示在按钮上,也是成员发出的消息,起一个好读的词,比如「新人导览」。 2. **配欢迎卡**。控制台 → 设置 → 欢迎与引导:主按钮保持「打开圈子」,网格按钮放你的入口,类型选**发送文本**,值 = 触发词。按钮文案 ≤20 字,主按钮与网格按钮合计 ≤18 个。配好可以发到自己的 Mixin 里预览。 3. **配自动回复**。控制台 → 群聊 → 自动回复,每个入口一条规则:触发词 = 按钮发送的文本,回复用**应用卡片**(标题 ≤36 字、描述 ≤1024 字、按钮 ≤18 个、按钮文案 ≤36 字)。叶子节点交给轻量类型:帮助文档用链接按钮、长教程回复成帖子、转人工回复联系人名片。 4. **留一条人工退路**。每个菜单末尾放一个「联系管理员」发送文本按钮,指向联系人名片回复 —— 找不到答案的成员要有出口。 :::note[维护成本] 树越深越难维护。把长内容放进帖子或帮助文档、用链接按钮直达 —— 以后改文档,不用动引导树。触发词与平台命令重名(如 `/help`)会覆盖该命令,控制台会明确提示,起名时避开即可。 ::: ## 变体 - **付费圈**:在欢迎卡加一个「查看套餐」链接按钮,直达会员购买页 —— 聊天里直接给入口,比等成员自己找到价格页更短。 - **口令玩法**:把发送文本按钮当「口令」,命中触发词回复一篇资料帖或红包 —— 群里活跃分子会替你传播口令。 - **英文圈子**:触发词区分大小写,英文按钮统一用小写触发词最省心(如 `tour`、`help`)。 ## 相关页面 - [欢迎体验设置](/creator-guide/welcome-experience) - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) - [首页入口](/creator-guide/home-entries) --- #### 案例三:交易大厅的付费门面 > 展示页面、频道顺序与首页入口 —— 把圈子装修成一间服务店面。 > > Source: https://docs.ohmy.xin/playbooks/trading-hub-storefront/ **圈子**:星海交易室 —— 一家做策略服务的交易圈(交易大厅布局,圈子 VIP)。 **问题**:策略、课程、服务散落在控制台各处;成员进来看到的是默认频道顺序,付费内容藏在三层点击之后 —— 服务再好,门面看不出来。 **目标**:成员打开圈子,三步之内到达付费内容;免费部分负责建立信任,付费部分负责转化。 ## 成员会经历什么 1. **打开主页**:频道导航第一位是**策略**(实时信号面板)—— 圈子的核心能力放在最显眼处。频道上方的胶囊行是三个快捷入口:**策略服务**(直达展示页面)、**行情速览**(外链)、**入门课程**(文章合集)。 2. **点进策略服务**:这是一个**展示页面**,按筛选标签收集着带胜率与带单场次的人物卡片 —— 老师们的资历一目了然。 3. **底部导航**:第二个标签就是策略服务页 —— 从任何页面一步回到这里;标签文案只写「服务」。 4. **被锁定的好奇心**:信息流里混着几篇锁定帖,需要邀请码解锁 —— 老成员的邀请码成了最好的推荐信。 5. **开播提醒**:每周直播课开始前,订阅的成员收到提醒,课程日历就在频道导航第二位。 ## 圈主要做的事 | 步骤 | 在哪里 | 做什么 | | --- | --- | --- | | 1. 建人物卡 | 设置 → 外观 → 布局定制 → 展示卡片 | 给每位老师建卡:标签(策略风格)+ 胜率 + 带单场次 | | 2. 建服务页 | 同抽屉 → 展示页面 | 「策略服务」页,筛选标签决定哪些卡片落在这里 | | 3. 排频道 | 同抽屉 → 布局 | 频道槽位把**策略**放第一位;课程第二位;可给频道改短名 | | 4. 占导航位 | 同抽屉 → 布局 | 底部导航中间槽位指向策略服务页,文案写「服务」 | | 5. 铺快捷入口 | 同抽屉 → 首页入口 | 胶囊行三个:展示页面(填页面数字 ID)+ 行情外链 + 课程合集 | | 6. 埋钩子 | 内容 → 帖子 | 几篇高质量锁定帖(邀请码解锁),给老成员一个推荐的理由 | :::note[门面逻辑] 频道顺序回答「你最擅长什么」,展示页面回答「凭什么信你」,胶囊行与导航位回答「付费内容在哪」,锁定帖回答「为什么现在就加入」。各自一个家,不要把卖点全堆在一张卡上。 ::: ## 变体 - **先免费后付费**:策略频道保持公开(信任来源),课程频道内容设为会员可见 —— 频道本身成为价目表。 - **没有直播课**:课程槽位换给策略或广场,展示页面照样成立 —— 三个频道槽位不要求全占满,空槽自动收起。 ## 相关页面 - [定制交易大厅](/creator-guide/customize-trading-hub) - [展示页面与展示卡片](/creator-guide/showcase-pages-cards) - [首页入口](/creator-guide/home-entries) - [会员与定价](/creator-guide/membership-and-pricing) --- #### 案例二:资讯中心的新成员动线 > 入门精选、首页入口文件夹、通知栏与置顶帖 —— 把「新成员三分钟」串成一条内容路线。 > > Source: https://docs.ohmy.xin/playbooks/newcomer-content-path/ **圈子**:每日笔记 —— 一家做市场解读的资讯圈(资讯中心布局,圈子 VIP)。 **问题**:内容很好,但新成员进圈后一脸茫然:信息流是滚的、来源是散的,三天没看到第一条真正有用的内容,第四天就沉默了。 **目标**:新成员入圈三分钟内 —— 收到第一批精选内容、知道去哪里找东西、知道下一步该干什么。 ## 成员会经历什么 1. **加入瞬间**:机器人送来欢迎卡(主按钮直达圈子首页),紧接着是**入门精选** —— 你挑好的三个资讯源卡片,点关注即订阅。 2. **打开首页**:顶部是圈名横幅与一行通知栏公告(「新成员先看新手入门」);下方目录的第一个文件夹就叫**新手入门**,里面是新手指南、一篇学习路径合集、一个精选资讯源。 3. **读完指南**:置顶帖里是「三步玩转本圈」—— 看精选、挑来源、进频道冒泡。 4. **想付费时**:新手入门文件夹旁边就是「开通会员」入口,点开即达购买页。 ## 圈主要做的事 | 步骤 | 在哪里 | 做什么 | | --- | --- | --- | | 1. 挑入门来源 | 内容 → 资讯源 | 把最有代表性的三个来源配成**入门精选**,新成员入圈自动收到 | | 2. 写新手指南 | 内容 → 帖子 | 一篇置顶的「三步玩转」,讲清楚内容的组织方式 | | 3. 搭首页文件夹 | 设置 → 外观 → 布局定制 → 首页入口 | 顶级建「新手入门」文件夹:新手指南 + 学习路径合集(文章合集)+ 一个精选资讯源;旁边放「开通会员」入口 | | 4. 配通知栏 | 设置 → 通知栏 | 一句指向新手入门的公告,全站常驻 | | 5. 统一叫法 | 设置 → 外观 → 布局定制 | 如果「来源」「资讯」不合口味,改成「频道」「快报」—— 首页文案与入口会跟着变 | :::note[为什么这样组合] 入门精选解决「第一眼有内容」,文件夹解决「知道去哪找」,通知栏与置顶解决「下一步做什么」,会员入口解决「想付费时伸手可及」。四件事分别有自己的家,不需要任何一个功能硬扛全部。 ::: ## 变体 - **有试用内容的圈子**:把学习路径合集设为**试用可见**,未付费成员也能读前几篇 —— 目录本身成为转化入口(见 [内容工具箱](/creator-guide/content-toolkit) 的可见级别)。 - **已有存量的老圈子**:把「往期归档」做成第二个文件夹,新手入门放第一位 —— 新人不迷路,老人有地方翻旧账。 ## 相关页面 - [欢迎体验设置](/creator-guide/welcome-experience) - [首页入口](/creator-guide/home-entries) - [定制资讯中心](/creator-guide/customize-story-hub) - [资讯源管理](/creator-guide/story-feeds-and-sources) --- #### 案例四:社区大厅的工具站 > 机器人入口、外链与单目标文件夹 —— 把社区大厅首页变成一张导航页。 > > Source: https://docs.ohmy.xin/playbooks/community-tool-station/ **圈子**:工具盒子 —— 一个聚合 Mixin 生态工具的社区(社区大厅布局,免费可用)。 **问题**:社群的价值在「把对的人和对的工具连起来」,但工具散落在各家机器人里,全靠群友口头问。 **目标**:成员打开圈子就是一张工具导航页 —— 常用机器人一站直达,圈主维护一次,全群受益。 ## 成员会经历什么 1. **打开首页**:没有信息流,整个首页就是**入口卡片**:行情机器人、空投日历机器人、客服机器人、两条常用外链,按使用频率排好。 2. **点任意卡片**:机器人入口直接跳进对应的 Mixin 机器人会话;外链打开网页。 3. **还没入圈的访客**:看到的是**介绍卡片** —— 圈主写的说明 + 按钮直达其中两个最常用工具。 4. **公告常驻**:顶部通知栏写着本周新增的工具。 ## 圈主要做的事 | 步骤 | 在哪里 | 做什么 | | --- | --- | --- | | 1. 收录机器人 | 内容 → 友情链接 | 把生态里的机器人加为友情链接,写好描述与标签 | | 2. 铺首页 | 内容 → 首页入口 | 顶级放**机器人入口**(从友情链接选)与**外部链接**;按使用频率排序 | | 3. 归拢冷门项 | 同页 | 偶尔用到的工具收进文件夹 —— 社区大厅里文件夹只用于后台分组,成员端只看顶级;**只含一个目标的文件夹会直接跳转**,正好当「别名」用 | | 4. 写介绍卡 | 设置 → 欢迎与引导 | 访客卡片放说明文字,按钮直达两个招牌工具(链接类型) | | 5. 发公告 | 设置 → 通知栏 | 本周新工具一句话常驻顶部 | :::note[社区大厅的特点] 没有频道、没有定制抽屉 —— 但首页入口就是全部门面,反而最像「做一站导航页」:不需要内容运营,只需要维护这张清单。机器人入口必须先存在于友情链接,这是唯一的依赖关系。 ::: ## 变体 - **搭配自动回复**:加一条触发词为「工具」的自动回复,回一张应用卡片列出新工具 —— 群里有人问,机器人替你答(见 [案例一](/playbooks/bot-onboarding))。 - **成员自助**:补「订单记录」「个人资料」入口,成员自助办事不用找管理员。 ## 相关页面 - [首页入口](/creator-guide/home-entries) - [内容工具箱(友情链接)](/creator-guide/content-toolkit) - [欢迎体验设置](/creator-guide/welcome-experience) - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) ### Reference / 参考 #### 定价与费用一览 > 全站所有数字的唯一出处 —— 平台服务费、圈子 VIP 价格与结算规则。 > > Source: https://docs.ohmy.xin/reference/pricing-and-fees/ 本页是 OhMy.xin 全部价格与费用数字的唯一出处。其他页面的数字以本页为准;调整价格时只需更新这里。 ## 平台服务费 | 项目 | 费率 | 说明 | | --- | --- | --- | | 会员 / 成员档位订单 | 10% | 成员每笔会员费或档位费中平台收取的部分;其余归圈主 | | 红包 / 抽奖 / 问答活动 | 0% | 活动资金全部归参与者 | ## 圈子 VIP(可选订阅,圈主购买) | 周期 | 价格 | | --- | --- | | 月付 | 9.99 | | 季付 | 29.99 | | 年付 | 99.99 | 支持 BTC、PUSD、USDT、XIN 支付。VIP 解锁的高级功能包括:资讯中心与交易大厅布局、超级大群广播模式、自定义支付币种、资讯源、抽奖与红包的参与者筛选、视频帖子、视频直播等。 ## 邀请奖励 由圈主自行设定,占每笔会员或成员档位订单的比例,上限 89%。设为 0 表示关闭。奖励支付给邀请该成员加入的老成员 —— 没有通过邀请加入的成员下单时不产生奖励,这部分归你。 ## 每笔收入怎么分 调整价格和邀请奖励,看看一笔会员费或档位费具体怎么分配。 ## 圈子会员定价 由圈主自行设定:固定价格或多个订阅方案,可配置首次优惠价、续费折扣与试用天数。成员实际支付金额以圈子套餐页展示为准。 **成员档位(Pro 内容)** 的价格、币种与时长同样由圈主设定,和进圈费分开计价;订单走同一套结算与邀请奖励规则。圈子 VIP 是圈主向平台购买的功能订阅,与成员档位是两回事。 ## 结算与时效 - 支付确认:通常几秒内生效。 - 圈主收入结算:订单完成后自动转入圈主 Mixin 钱包,通常几秒到几分钟,无需提现。 - 支付页有效期:15 分钟,超时重新发起。 - 订单查询:凭支付编号在订单页核对。 ## 相关页面 - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [会员与定价](/creator-guide/membership-and-pricing) - [常见问题](/reference/faq) --- #### 常见问题 > 新用户最常遇到的问题与解答。 > > Source: https://docs.ohmy.xin/reference/faq/ 每个问题下面就是简短回答,点开看详细说明。 ## 入门 **我需要先了解加密货币吗?** > 不需要。只有付费时才会用到钱包。 注册、看帖、聊天都不涉及钱包;只有在付费加入圈子或参与活动时才会用到,界面会一步步引导你。 **加入圈子要花多少钱?** > 免费圈子不花钱;付费圈子的价格在套餐页上。 付费圈子按圈主定的套餐收费,通常按月或按年,金额以圈子套餐页展示为准。整体费用规则见 [定价与费用一览](/reference/pricing-and-fees)。 **支付后多久生效?** > 几秒钟。 会员身份通常在几秒内生效。如果长时间未生效,用支付编号在订单页查询,或联系圈子管理员。 **为什么提示「请升级 Mixin Messenger」?** > 你的 Mixin Messenger 版本太旧,收不了转账,升级即可。 收取红包、打赏、奖品等转账需要较新版本的 Mixin Messenger。去应用商店升级后重新打开即可。 ## 资金 **运营圈子要花钱吗?** > 运营免费,平台从每笔会员或成员档位订单收取 10%。 红包、抽奖等幸运活动不收费。圈子 VIP 是可选订阅(月付 / 季付 / 年付)。详见 [定价与费用一览](/reference/pricing-and-fees)。 **圈主怎么提现?** > 不用提现,每笔订单的收入会自动打进钱包。 每笔订单完成时,平台自动把应得收入(扣除 10% 服务费和邀请奖励后)以 Mixin 转账直接打入圈主钱包,通常几秒到几分钟到账。详见 [资金:订单与到账](/creator-guide/money-orders-payouts)。 **红包和打赏的钱到哪里?** > 进你的 Mixin 钱包,通常几秒到账。 红包领取后几秒到账;打赏由平台即时转付全额,平台不抽成。长时间未到账时先升级 Mixin Messenger,再用支付编号核对。 **圈子 VIP 到期了会怎样?** > 已开启的照常运行,只是不能再开启新的 VIP 功能。 不能再开启新的 VIP 功能(如切换 VIP 布局、群聊模式)。续费从到期日顺延,随时可恢复全部能力,见 [圈子 VIP](/creator-guide/circle-vip)。 ## 隐私与帮助 **群里别人能看到我的消息吗?** > 只有群聊模式下能;其他模式下只有管理组能看到。 取决于圈子的聊天模式:静默(默认)、广播和讲座模式下,你的消息只发给管理组(讲座模式下管理组的发言全员可见);群聊模式下所有人都能看到。加入时机器人会私信告诉你当前模式,见 [在圈子里聊天](/member-guide/chatting)。 **我的发言会被公开核实身份吗?** > 匿名模式下不会。管理员可以私下核实,但不会公开。 匿名模式下普通成员匿名发言;管理员可以在必要时私下核实身份,但不会公开。发布诈骗或刷屏内容会被拦截、撤回甚至拉黑。 **如何获得帮助?** > 找圈子管理员,或给 OhMyBot 发送「客服」。 圈内的事找圈子管理员。平台相关的问题,在 Mixin Messenger 里给 OhMy.xin 官方机器人 OhMyBot 发送「客服」,它会回复客服的联系人卡片。常见问题也可以按 [排障指南](/reference/troubleshooting) 一步步解决。 --- #### 排错索引 > 按旅程阶段排列的「症状 → 去哪页」速查表。 > > Source: https://docs.ohmy.xin/reference/troubleshooting/ 点两下,找到最可能的原因和解决办法。 想直接扫一遍?下面按阶段列出了所有症状。 ## 加入与访问 | 症状 | 去哪 | | --- | --- | | 邀请链接打不开 | [加入一个圈子](/start-here/join-a-circle) —— 先确认装了 Mixin Messenger | | 内容带锁看不了 | [购买与续费会员](/member-guide/membership) / [加入圈子](/member-guide/joining) | | 只能看到部分内容(预览模式) | [角色与权限](/reference/roles-and-permissions) 的可见级别表 | | 想退出或重新加入圈子 | [账户](/member-guide/your-account) | ## 支付 | 症状 | 去哪 | | --- | --- | | 支付后会员没生效 | [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) | | 提示「请升级 Mixin Messenger」 | [圈主的收入与到账](/mixin-basics/owner-payouts) | | 付错金额、订单过期 | [支付详解](/reference/payments-deep-dive) | | 打赏或红包没到账 | [常见问题](/reference/faq) | ## 聊天与内容 | 症状 | 去哪 | | --- | --- | | 消息发送太频繁 | [在圈子里聊天](/member-guide/chatting) | | 消息被拦截为垃圾信息 | [常见问题](/reference/faq) 或联系管理员 | | 找不到发帖按钮 | [帖子、投票、提问与文章](/member-guide/posts-and-articles) | | 资讯源没有更新 | [资讯订阅](/member-guide/story-subscriptions) | ## 圈主 | 症状 | 去哪 | | --- | --- | | 密钥校验失败 / 自动配置失败 | [接入 OhMy.xin](/creator-guide/connect-to-ohmyxin) | | 资讯源抓取失败 | [资讯源管理](/creator-guide/story-feeds-and-sources) | | VIP 即将到期 / 功能被锁 | [圈子 VIP](/creator-guide/circle-vip) | | 圈子进入休眠 | [生命周期](/creator-guide/lifecycle) | | 收入没到账 / 订单异常 | [资金:订单与提现](/creator-guide/money-orders-payouts) | 以上都解决不了?在圈子里向管理员反馈,或在 Mixin Messenger 里给 OhMy.xin 官方机器人 OhMyBot 发送「客服」,它会回复客服的联系人卡片。 --- #### 支付详解 > 一笔钱从付款到结算的完整路径 —— 状态、拒绝原因、退款与查证。 > > Source: https://docs.ohmy.xin/reference/payments-deep-dive/ 本页把 OhMy.xin 的资金路径摊开讲清楚。金额与费率的数字以 [定价与费用一览](/reference/pricing-and-fees) 为准。 ## 一笔会员或档位费的生命周期 1. **下单** —— 成员选定套餐生成订单,**15 分钟内有效**,超时自动过期。 2. **付款** —— 成员经 Mixin 支付页(二维码或一键唤起)转账;也可选「使用其他资产支付」走 Mixpay 按实时牌价折算。 3. **确认** —— 平台轮询 Mixin 转账记录,通常几秒内(最迟约半分钟)检测到这笔转账并核对付款备注(系统自动处理,用户无需手填)。 4. **生效** —— 会员或档位立即激活;随后结算:平台收 10% 服务费,邀请奖励分给邀请人,其余直接转入圈主的 Mixin 钱包(平台发起的 Mixin 安全转账,通常几秒到几分钟到账)。 成员档位订单走同一条路径:费率、邀请奖励、付款备注与结算方式完全相同。 ## 订单状态 | 状态 | 含义 | | --- | --- | | 等待支付 | 已下单未付款,15 分钟倒计时 | | 已支付 | 转账确认,会员或档位已生效 | | 已完成 | 结算分账完成 | | 已过期 | 超时未付,无需处理 | ## 拒绝与退款 检测到转账但与订单不匹配时,这笔付款会被拒绝、不会生效,由平台核实后原路退回。常见原因: - **金额不足** —— 付款少于订单金额。 - **交易号不匹配** —— 转账对应不上任何等待支付的订单(比如重复支付同一订单)。 - **收款对象不对** —— 转账与订单的收款方信息对不上。 与订单不匹配的退款由平台人工核实后原路退回,需要一些处理时间,可凭支付编号联系支持。以下退款则是自动的:红包过期未领完的部分退回发起人;抽奖未中奖金自动退回奖池出资方。 ## 怎么查证一笔钱 - **订单详情** —— 成员在「我的」→ 订单 打开任意一笔订单,即可看到 **支付编号** 并直接跳到 Mixin 查看原始转账;圈主在收入 → 订单可按订单号 / 交易号 / 成员搜索。 - 每笔转账的支付编号全局唯一,是所有对账的锚点。 ## 相关页面 - [在 OhMy.xin 上支付](/mixin-basics/paying-on-ohmyxin) - [资金:订单与到账](/creator-guide/money-orders-payouts) --- #### 术语表 > OhMy.xin 指南使用的全部术语 —— 中文与英文对照。 > > Source: https://docs.ohmy.xin/reference/glossary/ 指南里用到的全部术语,附英文对照。输入中文或英文即可筛选,也可以按主题跳转。指南各页中带虚线下划线的词,悬停或点一下就能看到这里的释义。 --- #### 机器人命令 > 圈子机器人的全部命令 —— 按角色分组,含用法与限制。 > > Source: https://docs.ohmy.xin/reference/bot-commands/ 在圈子对话里发送命令即可触发。**/block、/recall、/report、/reveal 需要先引用目标消息**,再发送命令。记不住也没关系:发 `/help`,机器人会给你一排按你身份定制的快捷按钮。 ## 先试一试 选一个身份,点命令发出去 —— 回复都是机器人的原话。换个身份,可用的命令就会变。 ## 所有成员可用 | 命令 | 作用 | | --- | --- | | `/help` | 显示角色对应的快捷操作按钮 | | `/guide` | 获取圈子指南(成员收欢迎卡,管理组收指南链接) | | `/vote 帖子编号\|选项序号` | 给单选投票帖投票,如 `/vote 12\|1`(多选请在网页操作) | | `/lottery 帖子编号` | 参与抽奖帖 | | `/report` | 引用消息举报垃圾信息(仅成员角色可用;需圈子开启防骚扰) | ## 讲师与管理员追加 | 命令 | 作用 | | --- | --- | | `/default` | 切换到静默模式 | | `/lecture` | 切换到讲座模式(开始录制回放) | | `/qa` · `/qa on` · `/qa off` | 查看或开关讲座问答(当前无讲座时私聊回复) | ## 仅管理员 | 命令 | 作用 | | --- | --- | | `/broadcast` | 切换到广播模式 | | `/group` | 切换到群聊模式(需 [圈子 VIP](/creator-guide/circle-vip)) | | `/block` | 引用消息拉黑该成员 | | `/recall` | 引用消息撤回(30 天内有效) | | `/reveal` | 引用匿名成员的消息核实真实身份(仅匿名模式开启时可用,结果私信不公开) | ## 备注 - 模式切换立即对全圈生效,机器人会私信通知订阅了消息的成员。 - Oh My Luck 的活动没有聊天命令 —— 红包、抽奖、答题都在网页里参与。 ## 相关页面 - [角色与权限](/reference/roles-and-permissions) - [聊天模式与自动回复](/creator-guide/chat-modes-for-owners) --- #### 角色与权限 > 谁能做什么 —— 控制台、内容与互动权限的通俗版对照表。 > > Source: https://docs.ohmy.xin/reference/roles-and-permissions/ 圈子里能做什么、能看到什么,全由你的角色决定。点一个角色看看 —— 再切换圈子类型,看看非会员能看到的内容怎么变。 ## 全部角色对照 角色从高到低:所有者 → 管理员 → 讲师 → 会员 → 关注者 → 已过期;另有已封禁。管理员与讲师各有 10 个名额;试用会员与会员权限相同。 ## 内容可见级别 付费圈子的帖子、文章与资讯分三档:**公开** ⊆ **试用** ⊆ **仅会员**。 | 谁在看 | 公开 | 试用 | 仅会员 | | --- | :-: | :-: | :-: | | 管理组与付费会员 | 全文 | 全文 | 全文 | | 试用期成员 | 全文 | 全文 | 预览 | | 访客 / 关注者 / 已过期 | 全文 | 预览 | 预览 | > **以上是「预览模式」** > 付费圈子在 **设置 → 可见性 → 浏览模式** 里二选一:**预览模式**(上表)让非会员看到公开内容和其余内容的摘要;**封闭模式** 下非会员什么都看不到,必须先加入。免费圈子始终开放;私密圈子对访客完全隐藏。 > [Screenshot: 控制台设置里的浏览模式] ## 成员档位(Pro 内容层) 免费圈子也可以出售成员档位。发布帖子、文章、策略或公开回答时,作者可以把内容指定给某个档位: - **能读全文**:档位持有人、作者本人、圈主、管理员与讲师。 - **只能看预览**:其他成员看到预览与解锁卡片;购买了对应档位后立即展开全文。 - 档位和角色、进圈会员是三条独立的线:购买档位不会升级角色,也不会延长进圈会员。 - 进圈会员过期时,即使档位仍在有效期内,也要先续费进圈才能阅读档位内容;续费后剩余的档位时间照常保留。 ## 相关页面 - [成员与角色](/creator-guide/members-and-roles) - [机器人命令](/reference/bot-commands) ### Open platform / 开放平台 #### API 参考 > 开放 API v1 的基础地址、认证方式、响应与错误结构、分页约定、速率限制与错误码。 > > Source: https://docs.ohmy.xin/open-platform/api-reference/ 开放平台 v1 的完整接入规范。所有接口都遵循这里描述的统一约定,未来的业务接口也会以同样的方式挂载在 `/api/v1` 之下。 ## 接口索引 | 接口 | 鉴权 | 用途 | | --- | --- | --- | | `GET /api/v1/health` | 不需要 | 确认服务可达。 | | `GET /api/v1/me` | 需要 | 查看当前凭证所属的账号与密钥。 | | `GET /api/v1/strategies` | 需要 | 列出公开可见的交易策略。[查看详情](/open-platform/strategies) | | `GET /api/v1/lives` | 需要 | 列出公开可见的圈子直播。[查看详情](/open-platform/lives) | ## 基础地址与版本 - 基础地址:`https://ohmy.xin/api/v1` —— 开发者 API 页面底部的「快速接入指引」会显示你当前所在环境的基础地址。 - 生产环境强制 HTTPS。 - 路径带版本前缀 `/v1`;未来若有不兼容变更会引入新的版本前缀,旧版本按公告逐步退役。 ## 认证 除健康检查外,所有接口都需要在请求头携带 Bearer 密钥: ```http Authorization: Bearer omx_live_<8 位标识>_<32 位密文> ``` - 密钥在开发者 API 页面的账号详情里生成,形如 `omx_live_xxxxxxxx_yyyyyyyy…`。 - 平台只保存密钥的单向摘要;任何页面、响应与日志都不会再出现完整明文。 - 密钥被禁用或吊销、所属账号被停用或冻结后,下一次请求立即返回 `401`。 ## 统一响应结构 成功时返回 `data`,失败时返回 `error`,两者都附带 `meta.request_id`: ```json { "data": { "...": "..." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ```json { "error": { "code": "unauthorized", "message": "Invalid or inactive API credentials." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` `meta.request_id` 是本次请求的唯一追踪编号,同时出现在响应头 `X-Request-Id` 里;联系平台排查问题时请提供它。 ## 通用响应头 | 响应头 | 出现时机 | 说明 | | --- | --- | --- | | `X-Request-Id` | 所有响应 | 与 `meta.request_id` 一致 | | `X-RateLimit-Limit` | 鉴权通过后 | 当前账号每分钟请求上限 | | `X-RateLimit-Remaining` | 鉴权通过后及 `429` | 当前窗口剩余次数(限流时为 `0`) | | `X-RateLimit-Reset` | 鉴权通过后及 `429` | 窗口重置时间的 Unix 时间戳(秒) | | `Retry-After` | `429` | 建议等待的秒数 | ## 速率限制 - 每个 API 账号默认每分钟 **60** 次;平台可为个别账号调整上限 —— 开发者 API 页面的账号信息里显示的是当前生效值。 - 额度按账号计算:同一账号下的多把密钥共享同一个额度。 - 此外还有一层按来源 IP 计数的兜底限制(默认每分钟 **300** 次),对同一 IP 的全部 `/api/` 流量生效,不区分凭证是否有效。 - 触发限流时返回 `429` 与 `Retry-After`;请按提示等待后重试,而不是并发重试。被 IP 级限制拦下的 `429` 没有 `X-RateLimit-*` 头,文案为 "Too many requests. Please retry later.",也不会出现在调用记录里。 ## 错误码 | HTTP 状态 | `error.code` | 含义 | | --- | --- | --- | | `400` | `invalid_parameter` | 查询参数不合法。`error.details` 会逐条列出出错的参数,形如 `{ "param": "...", "reason": "..." }`。 | | `401` | `unauthorized` | 凭证缺失、格式非法、密钥被禁用/吊销,或所属账号被停用/冻结(对外统一文案,不区分具体原因)。 | | `404` | `not_found` | 接口路径不存在。 | | `429` | `rate_limit_exceeded` | 超出速率限制。 | | `503` | `service_unavailable` | 平台临时关闭了外部 API 服务。 | | `500` | `internal_error` | 服务端内部异常,请携带 `meta.request_id` 联系平台。 | > **为什么 401 不区分具体原因** > 统一的错误文案能防止调用方通过响应差异枚举密钥与账号状态。精确的失败原因记录在平台内部的调用日志里,账号所有者可以在开发者 API 页面查看自己账号的记录。 > ## 服务接口 ### 连通性健康检查 ``` GET /api/v1/health ``` 不需要鉴权,用于确认服务可达: ```json { "data": { "status": "ok", "version": "v1", "timestamp": "2026-11-15T22:15:00+08:00" }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ### 凭证与账号自检 ``` GET /api/v1/me ``` 需要鉴权,返回当前密钥所属的账号与密钥信息: ```json { "data": { "account": { "number": "8392014", "name": "Production Integration", "state": "active", "rate_limit_per_minute": 60 }, "key": { "name": "Primary Key", "masked_token": "omx_live_a1b2c3d4••••••••x9y0", "state": "active", "last_used_at": "2026-11-15T22:14:12+08:00" } }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` `account.state` 取值:`active`(启用中)、`disabled`(已停用)、`frozen`(已冻结);`key.state` 取值:`active`(启用中)、`disabled`(已禁用)、`revoked`(已吊销)。 ### 未注册路径 任何未注册的 `/api/*` 路径都返回统一的 `404` 信封,而不是内部错误页: ```json { "error": { "code": "not_found", "message": "API endpoint not found." }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## 集合接口 返回列表的接口共用同一套约定,针对其中一个写好的集成代码可以直接复用到下一个。 ### 通用查询参数 | 参数 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | `20` | 每页条数,取值范围 `1`–`100`。 | | `cursor` | 字符串 | — | 上一页返回的 `meta.pagination.next_cursor`。不透明字符串,请原样回传。 | | `sort` | 字符串 | 由接口决定 | 该接口自己支持的排序方式;游标与上一页使用的排序绑定。 | | `circle_number` | 字符串 | — | 只返回某个圈子的数据(最长 32 字符)。 | | `state` | 字符串 | 由接口决定 | 该接口允许的状态值,逗号分隔多个。 | | `updated_after` | ISO 8601 时间 | — | 更新时间下界(含)。 | 接口还可以在此基础上追加自己的筛选参数:策略接口有 `symbol`、`side`、`published_after`、`published_before`,直播接口有 `scheduled_after`、`scheduled_before`。 ### 分页信封 所有集合接口的响应都带同样的 `meta.pagination` 结构: ```json { "meta": { "pagination": { "limit": 20, "has_more": true, "next_cursor": "eyJzIjoi..." }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | 否 | 本次实际生效的每页条数。 | | `has_more` | 布尔 | 否 | 是否还有下一页。 | | `next_cursor` | 字符串 | 是 | 下一页游标;`has_more` 为 `false` 时为 `null`。 | 取下一页时,把 `next_cursor` 原样作为 `cursor` 传回,其余参数保持不变。换一种 `sort` 会让旧游标失效并返回 `400`。 ### 业务接口 - [策略列表](/open-platform/strategies) —— `GET /api/v1/strategies` - [直播列表](/open-platform/lives) —— `GET /api/v1/lives` ## 相关页面 - [策略列表](/open-platform/strategies) —— `GET /api/v1/strategies` - [直播列表](/open-platform/lives) —— `GET /api/v1/lives` - [快速开始](/open-platform/getting-started) - [开放平台概览](/open-platform/) - [OpenAPI 规范](/openapi.json) —— 所有接口的机器可读描述 --- #### 开放平台 > 用 API 把 OhMy.xin 接进你自己的系统 —— 账号、密钥、限流与调用记录,平台统一打理。 > > Source: https://docs.ohmy.xin/open-platform/ OhMy.xin 开放平台把平台的部分能力以 API 的形式开放给外部系统:你在网页上自助创建 **API 账号** 与 **API 密钥**,然后用自己的程序调用统一规范的开放接口。 鉴权、速率限制、统一的响应与错误格式、调用记录 —— 这些公共部分全部由平台承担,你只需要关心业务本身。 ## 现在开放了什么 统一接入框架提供了两个服务接口: - **连通性健康检查**(`GET /api/v1/health`)—— 不需要密钥,用来确认服务可达。 - **凭证与账号自检**(`GET /api/v1/me`)—— 用密钥调用,确认凭证有效并查看账号与密钥信息。 其上已经有两个业务接口可用: - **策略列表**(`GET /api/v1/strategies`)—— 公开可见的交易策略,可按圈子、标的、方向与时间窗口筛选。 - **直播列表**(`GET /api/v1/lives`)—— 公开可见的圈子直播,含状态、观众数与回放可用性。 具体的业务接口会在之后陆续挂载到同一套框架下。新接口自动继承同样的鉴权、限流、分页与错误规范,你的接入代码不需要为它们再做额外适配。 > **谁可以使用开放平台** > 所有已登录且状态正常的 OhMy.xin 用户都可以自助创建 API 账号与密钥,无需申请或审批;异常账号由平台管理员冻结。 > ## 核心概念 | 概念 | 说明 | | --- | --- | | API 账号 | 接入的主体单元,用来隔离不同的集成或环境(例如「生产环境」和「测试」各一个)。每个用户默认最多 5 个。 | | API 密钥 | 调用接口的凭证,挂在某个 API 账号下,以 `omx_live_` 开头。明文只在生成时展示一次,之后只显示脱敏片段。每个账号默认最多 10 把有效密钥。 | | 速率限制 | 每个 API 账号默认每分钟最多 60 次请求;此外对同一来源 IP 的全部 `/api/` 流量另有兜底限制(默认 300 次/分钟),不区分凭证是否有效。 | | 调用记录 | 进入网关处理的每一次请求(包括鉴权失败与触发限流)都会留下结构化记录,可在开发者 API 页面按密钥、时间、接口与结果筛选。默认保留 90 天;被 IP 级兜底限流直接拦截的请求不产生记录。 | | 请求追踪 ID | 每个响应都携带唯一的 `request_id`;排查问题时提供它,平台就能对齐日志。 | > **密钥安全** > 完整密钥只在生成那一刻展示一次,平台只保存不可逆的摘要。把它当作密码对待:不要写进公开的代码仓库,发现泄露立即吊销。 > ## 从这里开始 - [快速开始](/open-platform/getting-started) — 创建 API 账号、生成密钥、完成第一次调用,大约五分钟。 - [API 参考](/open-platform/api-reference) — 基础地址、认证方式、响应与错误结构、分页、速率限制与错误码表。 - [策略列表](/open-platform/strategies) — GET /api/v1/strategies —— 公开可见的交易策略,含筛选参数与完整字段说明。 - [直播列表](/open-platform/lives) — GET /api/v1/lives —— 公开可见的圈子直播、观众数与回放可用性。 ## 机器可读版本 同一套规范也提供机器可读形式,代码生成器与 LLM 工具调用可以直接消费: - [OpenAPI 3.1 规范](/openapi.json) —— 全部接口、参数与响应结构 - [llms.txt](/llms.txt) —— 页面索引 - [llms-full.txt](/llms-full.txt) —— 全部页面的完整正文 --- #### 快速开始 > 创建 API 账号、生成密钥并完成第一次调用,大约五分钟。 > > Source: https://docs.ohmy.xin/open-platform/getting-started/ 这一页带你从零接入开放平台:创建 API 账号、生成密钥,再用它完成第一次调用。操作在网页加一个终端里完成,大约五分钟。 ## 开始之前 - 一个可以登录的 OhMy.xin 账号(用 Mixin 登录即可)。 - 一个能发 HTTP 请求的终端或工具 —— 下面的示例用 `curl`,可以直接复制。 ## 1. 打开「开发者 API」 登录 OhMy.xin 网页版,点击右上角的**头像**打开菜单,选择 **开发者 API**。 ## 2. 创建 API 账号 点击 **新建 API 账号**,填写账号名称(必填)与用途说明(可选),提交后进入账号详情页,页面会显示账号编号、状态与当前的速率限制。 API 账号用来隔离不同的集成或环境 —— 比如给「生产环境」和「测试」各建一个。每个用户默认最多 5 个账号,上限按名下全部账号计算(含已停用的);不再使用的账号可以在详情页**停用**,但停用只是让它的密钥失效,不会腾出名额。 ## 3. 生成 API 密钥 在账号详情页找到 **API 密钥**,点击 **生成密钥** 并为它起个名字(例如「主用密钥」)。 > **完整密钥只展示一次** > 生成成功后,页面会展示形如 `omx_live_xxxxxxxx_yyyyyyyy…` 的完整密钥,**关闭或刷新页面后就再也看不到**。请立即复制并妥善保存。如果遗失,只能生成一把新密钥,再把旧的吊销。 > 之后密钥列表只显示名称、前缀与末尾几位的脱敏片段,绝不再显示完整明文。每个账号默认最多 10 把有效密钥 —— 这是有意为之,方便你**新旧并存、无中断轮换**(见下文)。 ## 4. 完成第一次调用 先试不需要密钥的连通性健康检查: ```bash curl -s https://ohmy.xin/api/v1/health ``` 再用你的密钥做凭证自检(把 `omx_live_…` 换成刚保存的完整密钥): ```bash curl -s https://ohmy.xin/api/v1/me \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` 调用成功会返回统一结构的 JSON,包含你的账号与密钥信息: ```json { "data": { "account": { "number": "8392014", "name": "生产环境集成", "state": "active", "rate_limit_per_minute": 60 }, "key": { "name": "主用密钥", "masked_token": "omx_live_a1b2c3d4••••••••x9y0", "state": "active", "last_used_at": "2026-11-15T22:14:12+08:00" } }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## 5. 拉一次真实数据 前两个内置接口确认链路通畅。要取到实际数据,调用业务接口即可 —— 它们共用同一套鉴权、限流与分页规则: ```bash curl -s "https://ohmy.xin/api/v1/strategies?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` ```bash curl -s "https://ohmy.xin/api/v1/lives?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy" ``` 两个接口都返回数组形式的 `data`,外加 `meta.pagination`。当 `meta.pagination.has_more` 为 `true` 时,把 `meta.pagination.next_cursor` 原样作为 `cursor` 参数传回即可取下一页。全部筛选参数与字段见[策略列表](/open-platform/strategies)与[直播列表](/open-platform/lives)。 ## 6. 查看调用记录 回到 **开发者 API** 页面并进入对应账号,**近期调用记录**会列出每一次请求的时间、接口、状态码、结果、耗时与来源 IP,可按密钥、时间范围、接口与结果筛选,页首还有成功 / 失败次数的小结。 记录由平台异步采集,会比请求本身稍晚出现;被 IP 级兜底限流直接拦截的请求不会出现在记录里;明细默认保留 90 天。 ## 换密钥不用停服务 密钥支持无中断轮换: 1. 在同一账号下**生成一把新密钥**; 2. 把外部系统里的密钥换成新密钥,确认调用正常; 3. 在列表里**吊销**旧密钥 —— 它的下一次请求立即被拒绝。 发现密钥泄露时不用等轮换:直接**禁用**(之后可再启用)或**吊销**(永久失效),改动立即生效。 ## 出问题了 | 现象 | 原因与处理 | | --- | --- | | `401 unauthorized` | 凭证缺失、密钥不完整或写错、密钥被禁用/吊销,或所属账号被停用/冻结。出于安全考虑,平台不区分具体原因 —— 先检查密钥是否完整复制、状态是否为「启用中」。 | | `429 rate_limit_exceeded` | 触发限流。响应头 `Retry-After` 给出建议等待秒数;账号默认每分钟 60 次。 | | `404 not_found` | 接口路径不存在。当前开放的接口是 `/api/v1/health`、`/api/v1/me`、`/api/v1/strategies` 与 `/api/v1/lives` —— 见[API 参考](/open-platform/api-reference)。 | | `400 invalid_parameter` | 查询参数不合法。`error.details` 会指出出错的参数,可接受的值见对应接口页。 | | 响应里没有 `X-RateLimit-*` 头 | 两种可能:`Authorization` 请求头格式不对(鉴权未通过),或被 IP 级兜底限流拦下 —— 后者的文案是 "Too many requests. Please retry later.",先看响应文案区分。 | ## 相关页面 - [API 参考](/open-platform/api-reference) - [策略列表](/open-platform/strategies) - [直播列表](/open-platform/lives) - [开放平台概览](/open-platform/) --- #### 直播列表 > GET /api/v1/lives —— 列出公开可见的圈子直播,含状态、观众数与回放可用性,支持游标分页。 > > Source: https://docs.ohmy.xin/open-platform/lives/ `GET /api/v1/lives` 返回平台上**公开可见**的圈子直播列表 —— 即将开始、正在直播、中断与已结束(含回放)的直播。 ## 契约摘要 | 项 | 值 | | --- | --- | | 方法与路径 | `GET /api/v1/lives` | | 完整地址 | `https://ohmy.xin/api/v1/lives` | | 鉴权 | 需要 Bearer 密钥 | | 请求体 | 无 | | 响应 | `data` 为直播对象数组,`meta.pagination` 为分页信息 | | 分页 | 游标(cursor)分页,默认每页 20 条,上限 100 条 | | 可见性 | 仅返回已列入目录、且圈子公开的直播 | ## 请求 ```http GET /api/v1/lives HTTP/1.1 Host: ohmy.xin Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy... Accept: application/json ``` 鉴权、限流与错误信封遵循统一的[接口约定](/open-platform/api-reference),本页只描述该接口特有的部分。 ## 查询参数 全部参数都是可选的;不传任何参数时返回默认排序下的第一页。 | 参数 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | `20` | 每页条数,取值范围 `1`–`100`。超出范围返回 `400`。 | | `cursor` | 字符串 | — | 上一页返回的 `meta.pagination.next_cursor`。不透明字符串,请原样回传。 | | `sort` | 字符串 | `created_at:desc` | 排序方式,可选 `created_at:desc`(按创建时间倒序)或 `updated_at:desc`(按更新时间倒序)。 | | `circle_number` | 字符串 | — | 按圈子筛选,填写圈子的 `number`(最长 32 字符)。 | | `state` | 字符串 | `scheduled,live,interrupted` | 按状态筛选,逗号分隔多个值。可选值:`scheduled`、`live`、`interrupted`、`ended`。 | | `scheduled_after` | ISO 8601 时间 | — | 计划开播时间的下界(含)。 | | `scheduled_before` | ISO 8601 时间 | — | 计划开播时间的上界(含)。 | | `updated_after` | ISO 8601 时间 | — | 更新时间下界(含)。 | > **排序与游标绑定** > 游标里记录了上一页使用的 `sort`。换一种 `sort` 之后,旧游标会返回 `400 invalid_parameter`,请先不带 `cursor` 重新取第一页。 > > **时间窗口必须有序** > `scheduled_after` 必须早于或等于 `scheduled_before`,否则返回 `400 invalid_parameter`。 > ### 示例请求 ```bash curl -s "https://ohmy.xin/api/v1/lives?limit=2&state=scheduled,live&circle_number=7000101526" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` ## 响应 ### `data[]` 字段 `data` 是一个数组,每个元素代表一场直播。 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `number` | 字符串 | 否 | 直播编号(公开标识)。**不返回内部 `id`**。 | | `title` | 字符串 | 否 | 直播标题。 | | `description` | 字符串 | 是 | 直播简介;没有时为 `null`。 | | `kind` | 字符串 | 否 | 直播类型,当前恒为 `video`。 | | `state` | 字符串 | 否 | 状态:`scheduled`(已排期)、`live`(直播中)、`interrupted`(中断)、`ended`(已结束)。 | | `url` | 字符串 | 否 | 直播间地址,可直接分享给用户。 | | `cover_url` | 字符串 | 是 | 封面图地址;没有时为 `null`。 | | `viewer_count` | 整数 | 是 | 当前观众数。**仅在直播中(`live` / `interrupted`)有值**,其余状态恒为 `null`。 | | `scheduled_at` | ISO 8601 时间 | 是 | 计划开播时间。 | | `started_at` | ISO 8601 时间 | 是 | 实际开播时间。 | | `ended_at` | ISO 8601 时间 | 是 | 结束时间。 | | `duration_seconds` | 整数 | 否 | 直播时长(秒)。未开播或未结束时为 `0`。 | | `replay_available` | 布尔 | 否 | 回放是否可用:已结束、回放可见且录制已就绪时为 `true`。 | | `comments_count` | 整数 | 否 | 评论数。 | | `reminders_count` | 整数 | 否 | 提醒预约数。 | | `updated_at` | ISO 8601 时间 | 否 | 最近一次更新时间。 | | `circle` | 对象 | 否 | 直播所属圈子,见下表。 | | `host` | 对象 | 是 | 主播;无法取得时为 `null`。 | > **观众数不是稳定的计数器** > `viewer_count` 来自平台的实时在线统计,只在直播进行中有值;开播前、结束后以及状态切换的瞬间都可能读到 `null`。需要稳定口径时请以自己的采样记录为准。 > ### `circle` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `number` | 字符串 | 否 | 圈子编号,可直接用于筛选参数 `circle_number`。 | | `name` | 字符串 | 否 | 圈子名称。 | | `url` | 字符串 | 否 | 圈子主页地址,直播频道视图。 | | `avatar_url` | 字符串 | 是 | 圈子头像地址。 | ### `host` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `name` | 字符串 | 否 | 主播昵称。 | | `avatar_url` | 字符串 | 是 | 主播头像地址。 | ### `meta.pagination` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | 否 | 本次实际生效的每页条数。 | | `has_more` | 布尔 | 否 | 是否还有下一页。 | | `next_cursor` | 字符串 | 是 | 下一页游标;`has_more` 为 `false` 时为 `null`。 | ### 示例响应 ```json { "data": [ { "number": "9100004", "title": "On air now", "description": "Weekly market outlook", "kind": "video", "state": "live", "url": "https://ohmy.xin/circles/7000101526/lives/9100004", "cover_url": "https://ohmy.xin/circles/7000101526/lives/9100004/card_cover.png?v=1a2b3c4d", "viewer_count": 42, "scheduled_at": null, "started_at": "2024-01-16T10:00:00+08:00", "ended_at": null, "duration_seconds": 0, "replay_available": false, "comments_count": 12, "reminders_count": 7, "updated_at": "2024-01-16T10:30:00+08:00", "circle": { "number": "7000101526", "name": "Crypto Lab", "url": "https://ohmy.xin/circles/7000101526?channel=live", "avatar_url": "https://cdn.ohmy.xin/circles/7000101526/avatar.webp" }, "host": { "name": "Alice", "avatar_url": "https://cdn.ohmy.xin/users/a1b2c3/avatar.webp" } } ], "meta": { "pagination": { "limit": 20, "has_more": false, "next_cursor": null }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## 分页 游标分页:先取第一页,拿到 `meta.pagination.next_cursor`,把它原样作为下一页的 `cursor` 参数,直到 `has_more` 为 `false`。 ```bash # 第一页 curl -s "https://ohmy.xin/api/v1/lives?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." # 下一页 —— 把上一步返回的 next_cursor 原样带上 curl -s "https://ohmy.xin/api/v1/lives?limit=2&cursor=eyJzIjoidHJlYXRlZF9hdDpkZXNjIiwiYyI6WyIyMDI0LTAxLTE2VDAyOjAwOjAwWiIsOTEwMDAwNF19" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` > **不要自己拼装游标** > 游标是平台签发的不透明字符串,内部编码了排序方式与游标位置。自己构造、改写或跨接口复用都会返回 `400 invalid_parameter`。同一游标可以在重复请求中安全重放。 > ## 可见性规则 一场直播出现在列表里,需要**同时**满足: 1. 直播已被圈主列入直播目录(`directory_listed` 为真); 2. 直播状态为 `scheduled`、`live`、`interrupted` 或 `ended` 之一; 3. 所属圈子满足:已绑定 Mixin、未休眠、圈子状态为公开。 > **直播与策略的圈子门槛不同** > 策略接口只收录**免费或预告模式**的圈子,直播接口只要求圈子公开 —— 因此**付费圈子的直播同样会出现在公开 API 中**。两个接口的圈子可见范围并不一致,需要按接口分别判断。 > > **直播功能未全量开放时,列表为空** > 当直播功能未对全部用户开放,或直播服务商尚未配置完成时,本接口返回 `200` 与**空数组**(`data: []`,`has_more: false`)—— 而不是报错。请据此区分「暂时没有直播」与「直播功能未开放」。 > > **接口不暴露内部字段** > 响应只包含面向公开访问者的字段。直播内部 `id`、圈子内部 ID、主播 ID、推流名(`stream_name`)、推流凭证过期时间(`ingest_expires_at`)、服务商信息与统计数据(`unique_viewers`、`peak_viewers`、`members_joined`)以及主播的 Mixin UUID 都不会出现。 > ## 错误 该接口在统一的错误信封之外,只多一种情况: | HTTP 状态 | `error.code` | 触发条件 | | --- | --- | --- | | `400` | `invalid_parameter` | 查询参数不合法:`limit` 越界、`sort`/`state` 取值非法、时间格式错误、时间窗口颠倒,或游标无效。 | `400` 的 `error.details` 会逐条列出出错的参数: ```json { "error": { "code": "invalid_parameter", "message": "Invalid query parameter: state must contain only: scheduled, live, interrupted, ended.", "details": [ { "param": "state", "reason": "must contain only: scheduled, live, interrupted, ended" } ] }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` 其余状态码(`401`、`429`、`503`、`500`)的含义见[接口约定](/open-platform/api-reference#错误码)。 ## 相关页面 - [接口约定](/open-platform/api-reference) —— 鉴权、限流、响应信封与错误码 - [快速开始](/open-platform/getting-started) —— 创建账号、生成密钥、完成第一次调用 - [策略列表](/open-platform/strategies) —— 另一个列表接口 - [OpenAPI 规范](/openapi.json) —— 本接口的机器可读描述(OpenAPI 3.1) --- #### 策略列表 > GET /api/v1/strategies —— 列出平台上公开可见的交易策略,支持按圈子、标的、方向与时间窗口筛选,使用游标分页。 > > Source: https://docs.ohmy.xin/open-platform/strategies/ `GET /api/v1/strategies` 返回平台上**公开可见**的交易策略(signal)。返回的是策略卡片本身的内容 —— 标的、方向、入场价、目标价、止损价、止盈阶梯 —— 加上所属圈子与发布者的展示信息。 ## 契约摘要 | 项 | 值 | | --- | --- | | 方法与路径 | `GET /api/v1/strategies` | | 完整地址 | `https://ohmy.xin/api/v1/strategies` | | 鉴权 | 需要 Bearer 密钥 | | 请求体 | 无 | | 响应 | `data` 为策略对象数组,`meta.pagination` 为分页信息 | | 分页 | 游标(cursor)分页,默认每页 20 条,上限 100 条 | | 可见性 | 仅返回对公开访问者可见的策略 | ## 请求 ```http GET /api/v1/strategies HTTP/1.1 Host: ohmy.xin Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy... Accept: application/json ``` 鉴权、限流与错误信封遵循统一的[接口约定](/open-platform/api-reference),本页只描述该接口特有的部分。 ## 查询参数 全部参数都是可选的;不传任何参数时返回默认排序下的第一页。 | 参数 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | `20` | 每页条数,取值范围 `1`–`100`。超出范围返回 `400`。 | | `cursor` | 字符串 | — | 上一页返回的 `meta.pagination.next_cursor`。不透明字符串,请原样回传。 | | `sort` | 字符串 | `published_at:desc` | 排序方式,可选 `published_at:desc`(按发布时间倒序)或 `updated_at:desc`(按更新时间倒序)。 | | `circle_number` | 字符串 | — | 按圈子筛选,填写圈子的 `number`(最长 32 字符)。 | | `symbol` | 字符串 | — | 按交易标的筛选,**不区分大小写**(最长 32 字符),例如 `BTC`、`btc` 等价。 | | `side` | 字符串 | — | 按方向筛选,可选 `long`(做多)或 `short`(做空)。 | | `state` | 字符串 | `running,take_profit,stop_loss` | 按状态筛选,逗号分隔多个值。可选值:`running`、`take_profit`、`stop_loss`。 | | `published_after` | ISO 8601 时间 | — | 发布时间下界(含)。 | | `published_before` | ISO 8601 时间 | — | 发布时间上界(含)。 | | `updated_after` | ISO 8601 时间 | — | 更新时间下界(含)。 | > **排序与游标绑定** > 游标里记录了上一页使用的 `sort`。换一种 `sort` 之后,旧游标会返回 `400 invalid_parameter`,请先不带 `cursor` 重新取第一页。 > > **时间窗口必须有序** > `published_after` 必须早于或等于 `published_before`,否则返回 `400 invalid_parameter`。同一约束也适用于直播接口的 `scheduled_after` / `scheduled_before`。 > ### 示例请求 ```bash curl -s "https://ohmy.xin/api/v1/strategies?limit=2&symbol=BTC&side=long&state=running" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` ## 响应 ### `data[]` 字段 `data` 是一个数组,每个元素代表一条策略。 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `id` | 整数 | 否 | 策略的记录 ID,可用于长期去重与幂等处理。 | | `symbol` | 字符串 | 否 | 交易标的,按发布者录入的原样返回 —— 平台不统一大小写,请按大小写不敏感的方式匹配。 | | `side` | 字符串 | 否 | 方向:`long`(做多)或 `short`(做空)。 | | `state` | 字符串 | 否 | 状态:`running`(进行中)、`take_profit`(已止盈)、`stop_loss`(已止损)。 | | `entry_price` | 字符串 | 否 | 入场价。 | | `target_price` | 字符串 | 否 | 目标价。 | | `stop_price` | 字符串 | 否 | 止损价。 | | `exit_price` | 字符串 | 是 | 实际离场价;策略尚未结束时为 `null`。 | | `target_stages` | 数组 | 否 | 止盈阶梯,逐级记录目标价与到达情况,见下表。 | | `note` | 字符串 | 是 | 发布者附带的说明文字;没有时为 `null`。 | | `source_name` | 字符串 | 是 | 信号来源的展示名称;没有时为 `null`。 | | `external_url` | 字符串 | 是 | 原始信号的外部链接;没有时为 `null`。 | | `published_at` | ISO 8601 时间 | 否 | 发布时间。 | | `closed_at` | ISO 8601 时间 | 是 | 结束时间;策略仍在进行时为 `null`。 | | `updated_at` | ISO 8601 时间 | 否 | 最近一次更新时间。 | | `circle` | 对象 | 否 | 策略所属圈子,见下表。 | | `author` | 对象 | 是 | 发布该策略的成员;无法取得时为 `null`。 | 所有价格字段都是**字符串**而非数字 —— 小数点后的零会被去掉(`65000.00` 返回为 `"65000"`),需要参与计算时请自行转换,避免浮点误差。 ### `target_stages[]` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `level` | 整数 | 否 | 阶梯序号,从 `1` 开始递增。 | | `price` | 字符串 | 否 | 该级的目标价。 | | `reached_at` | ISO 8601 时间 | 是 | 到达该级的时间;尚未到达时为 `null`。 | | `reached_price` | 字符串 | 是 | 到达该级时的实际价格;尚未到达时为 `null`。 | ### `circle` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `number` | 字符串 | 否 | 圈子编号,可直接用于筛选参数 `circle_number`。 | | `name` | 字符串 | 否 | 圈子名称。 | | `url` | 字符串 | 否 | 圈子主页地址,策略频道视图。 | | `avatar_url` | 字符串 | 是 | 圈子头像地址。 | ### `author` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `name` | 字符串 | 否 | 发布者昵称。 | | `avatar_url` | 字符串 | 是 | 发布者头像地址。 | ### `meta.pagination` 字段 | 字段 | 类型 | 可为 null | 说明 | | --- | --- | --- | --- | | `limit` | 整数 | 否 | 本次实际生效的每页条数。 | | `has_more` | 布尔 | 否 | 是否还有下一页。 | | `next_cursor` | 字符串 | 是 | 下一页游标;`has_more` 为 `false` 时为 `null`。 | ### 示例响应 ```json { "data": [ { "id": 4821, "symbol": "BTC", "side": "long", "state": "running", "entry_price": "65000", "target_price": "70000", "stop_price": "62000", "exit_price": null, "target_stages": [ { "level": 1, "price": "67000", "reached_at": "2024-01-15T04:00:00+08:00", "reached_price": "67050.5" }, { "level": 2, "price": "68500", "reached_at": null, "reached_price": null } ], "note": "日线级别突破,回踩不破则继续持有。", "source_name": "BTC 趋势跟踪", "external_url": "https://example.com/signals/btc-4821", "published_at": "2024-01-15T10:00:00+08:00", "closed_at": null, "updated_at": "2024-01-16T09:30:00+08:00", "circle": { "number": "7000101526", "name": "Crypto Lab", "url": "https://ohmy.xin/circles/7000101526?channel=strategy", "avatar_url": "https://cdn.ohmy.xin/circles/7000101526/avatar.webp" }, "author": { "name": "Alice", "avatar_url": "https://cdn.ohmy.xin/users/a1b2c3/avatar.webp" } } ], "meta": { "pagination": { "limit": 20, "has_more": true, "next_cursor": "eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19" }, "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` ## 分页 游标分页:先取第一页,拿到 `meta.pagination.next_cursor`,把它原样作为下一页的 `cursor` 参数,直到 `has_more` 为 `false`。 ```bash # 第一页 curl -s "https://ohmy.xin/api/v1/strategies?limit=2" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." # 下一页 —— 把上一步返回的 next_cursor 原样带上 curl -s "https://ohmy.xin/api/v1/strategies?limit=2&cursor=eyJzIjoidXB1bGlzaGVkX2F0OmRlc2MiLCJjIjpbIjIwMjQtMDEtMTVUMDI6MDA6MDBaIiw0ODIxIl19" \ -H "Authorization: Bearer omx_live_xxxxxxxx_yyyyyyyy..." ``` > **不要自己拼装游标** > 游标是平台签发的不透明字符串,内部编码了排序方式与游标位置。自己构造、改写或跨接口复用都会返回 `400 invalid_parameter`。同一游标可以在重复请求中安全重放。 > ## 可见性规则 一条策略出现在列表里,需要**同时**满足: 1. 策略状态为 `running`、`take_profit` 或 `stop_loss` 之一; 2. 策略已发布(`published_at` 非空); 3. 策略没有设置成员档位门槛,且受众为公开(`everyone`); 4. 所属圈子满足:已绑定 Mixin、未休眠、圈子状态为公开,且**免费或以「预告」模式浏览**。 第 4 条意味着:**付费且关闭浏览的圈子,其策略不会出现在公开 API 中**。若某个圈子号查不到策略,先确认它是否属于这一类。 > **接口不暴露内部字段** > 响应只包含面向公开访问者的字段。圈子内部 ID、发布者 Mixin UUID、档位门槛与原始信号载荷都不会出现在响应里 —— 即使能推断,也不应依赖。 > ## 错误 该接口在统一的错误信封之外,只多一种情况: | HTTP 状态 | `error.code` | 触发条件 | | --- | --- | --- | | `400` | `invalid_parameter` | 查询参数不合法:`limit` 越界、`sort`/`state`/`side` 取值非法、时间格式错误、时间窗口颠倒,或游标无效。 | `400` 的 `error.details` 会逐条列出出错的参数: ```json { "error": { "code": "invalid_parameter", "message": "Invalid query parameter: limit must be an integer between 1 and 100.", "details": [ { "param": "limit", "reason": "must be an integer between 1 and 100" } ] }, "meta": { "request_id": "9f4f2d1e-7c3b-4c68-9f9f-0a1b2c3d4e5f" } } ``` 其余状态码(`401`、`429`、`503`、`500`)的含义见[接口约定](/open-platform/api-reference#错误码)。 ## 相关页面 - [接口约定](/open-platform/api-reference) —— 鉴权、限流、响应信封与错误码 - [快速开始](/open-platform/getting-started) —— 创建账号、生成密钥、完成第一次调用 - [直播列表](/open-platform/lives) —— 另一个列表接口 - [OpenAPI 规范](/openapi.json) —— 本接口的机器可读描述(OpenAPI 3.1) ### Overview / 概览 #### OhMy.xin 使用指南 > 从零开始在 Mixin Messenger 里加入或创建圈子 —— 图文步骤、常见问题与排错指南。 > > Source: https://docs.ohmy.xin/ - [什么是 OhMy.xin?](/start-here/what-is-ohmyxin) — 一页读懂这个平台,以及为什么它运行在 Mixin Messenger 里。 - [什么是 Mixin Messenger?](/mixin-basics/what-is-mixin) — 圈子生活的地方:一款聊天加钱包的手机应用。 - [加入一个圈子](/start-here/join-a-circle) — 从一条邀请链接到发出第一条消息,大约十分钟。 - [创建自己的圈子](/start-here/create-a-circle) — 创建 Mixin 机器人并完成接入,开启你的付费社区。 - [常见问题](/reference/faq) — 新用户最常遇到的问题与解答。 - [定价与费用一览](/reference/pricing-and-fees) — 平台服务费、圈子 VIP 价格与结算规则。 - [术语表](/reference/glossary) — 全部术语的中英文对照。 - [开放平台](/open-platform/) — 创建 API 账号与密钥,把 OhMy.xin 接进你自己的系统。 --- #### 更新日志 > 平台的重要功能与修复,最新在前。 > > Source: https://docs.ohmy.xin/whats-new/ ## 开放平台:策略与直播成为公开 API 接口 `/api/v1` 下新增两个业务接口,与原有的健康检查、凭证自检并列。`GET /api/v1/strategies` 列出公开可见的交易策略,含标的、方向、入场 / 目标 / 止损价与止盈阶梯,可按圈子、标的、方向、状态与发布时间窗口筛选。`GET /api/v1/lives` 列出公开可见的圈子直播,含状态、观众数与回放可用性,可按圈子、状态与计划开播时间窗口筛选。两者都使用游标分页,返回统一响应信封,并继承平台同一套鉴权、限流与错误规范。完整契约按接口分别成文,同时提供机器可读的 OpenAPI 3.1 规范。 ## 开放平台:自助创建 API 账号与密钥 平台开放了统一的外部 API:任何已登录用户都可以在头像菜单 → 开发者 API 里创建 API 账号、生成密钥,并调用 `/api/v1` 下的开放接口(连通性健康检查与凭证自检,业务接口挂载在同一套框架下)。鉴权、每分钟速率限制与调用记录由平台统一处理;完整密钥只在生成时展示一次,支持新旧并存的无中断轮换与即时吊销。 ## 成员档位:免费进圈,Pro 内容单独付费 圈子现在可以在进圈之外再卖一层 Pro 内容:控制台 → 收入 → 成员档位里填写档位名称、说明、价格、币种与时长,再在发帖、写文章、建策略或回答提问时选择「阅读权限」。没有购买档位的成员看到预览与解锁入口;购买只解锁内容,不会改变角色、进圈会员或到期时间。 ## Oh My Live:沉浸式直播间、按网络选线路、聊天跟随聊天模式 直播间改为全屏舞台:聊天与输入框浮在视频上,手机全屏、桌面侧栏;停播时隐藏观众数与输入框。播放线路按观众所在网络自动选择(境外 LEB → FLV → HLS,大陆 FLV → HLS),检测不到时可在房间内切换并记住选择。/live 首页与圈子主页的直播条也同步改版:正在直播、即将开始与回放一览。 ## 策略管理拆成标签页,信号导入交给圈主配置 控制台的策略管理现在分为策略列表、免责声明、信号导入三个标签页。平台只决定哪个圈子能接收哪个信号来源;是否导入、存为草稿还是自动发布、按计划或分析师筛选、策略署谁的名,都由圈主在「信号导入」里决定(默认关闭)。 ## 隐藏成员数时,成员列表一并隐藏 开启「隐藏成员数」后,成员与访客不仅看不到人数,成员列表也只保留管理团队;圈主和管理员仍可看到完整列表。 ## 首页入口管理移入布局定制抽屉 资讯中心与交易大厅的首页入口现在在布局定制抽屉的「首页入口」标签页里管理:列表、新增、编辑与删除都在抽屉内完成,与展示页面、展示卡片标签页的交互一致;社区大厅没有定制抽屉,仍在内容分区维护。 ## 交易大厅策略走进成员端 交易大厅的圈主和管理员现在可以直接在成员主页新建与维护策略:发布立即上线并通知订阅成员,卡片菜单按状态提供编辑、止盈、止损、取消与删除。 ## 控制台外观改版:布局轨道与自定义抽屉 设置 → 外观改为横向布局轨道,切换前明确提示成员端体验的得失;每个布局的「布局定制」在右侧抽屉完成,交易大厅的展示页面与展示卡片也移入抽屉内直接管理。