> For the complete documentation index, see [llms.txt](https://docs.pages.koto.trade/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pages.koto.trade/product/referral.md). # Referral Referral lets Koto users invite other traders, see how their referral network is growing, and track eligible referral bonuses from referred activity. ## Business Purpose Koto Referral helps growth come from active users. It gives users a clear invite link, makes referral relationships visible, and connects eligible trading activity to referral rewards when the program rules allow it. ## Description The Referral area is where a signed-in user can find their referral link, share it with others, review direct and network-level referral activity, and see eligible bonuses. When a new user arrives through a referral link, Koto can show who invited them and preserve the referral intent through signup where attribution is available. Referral is connected to trading activity, but it is not the same as a competition. Competitions are time-based campaigns with their own rules. Referral is an ongoing invite and attribution system where rewards depend on referral eligibility, referred-user activity, and claim availability. ## How It Works 1. The user opens the Referral area and copies their invite link. 2. The user shares the link with another trader. 3. The invited trader opens Koto through the referral link and signs in or creates an account. 4. Koto records the referral relationship when the invite can be attributed. 5. The referrer can review referred users, network activity, and eligible bonus totals where available. 6. When a bonus is claimable, the user can claim it into their eligible account. ## What It Supports * A shareable referral link and referral code for each eligible signed-in user. * Referral attribution from inbound invite links where the invited user can be matched to the referral code. * Direct referral counts and network views where referral relationships are available. * Referred-user activity context such as trade counts where supported by the data source. * Lifetime referral bonus totals grouped by supported currency. * Claimable referral bonus display and claim action where the user has an eligible account. * Notifications or confirmation messaging when a referral invite is resolved where available. ## Referral Details ### Invite Links Each eligible user can use a referral code or link to invite other traders. The link is designed to carry referral intent into the app so the invited user can be connected to the referrer during signup or login when the referral is valid. ### Referral Network The Referral area helps users understand who they invited and how the network is performing. Counts and lists can include direct referrals and broader network views where supported. Some views may show activity status or trade counts so the referrer can understand whether referred users are active. ### Bonuses And Claims Referral bonuses depend on program rules and eligible referred activity. Bonus totals should be shown in the supported currency instead of combining unlike currencies. A user can claim only the amount that is currently available to claim; activity that has not yet been processed or is not eligible may not appear as claimable. ### Eligibility Referral availability depends on account state, referral attribution, program rules, and supported trading activity. A referral link does not guarantee that every signup, trade, or bonus will qualify. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.pages.koto.trade/product/referral.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.