pump fun holder rewards：持有人獎勵幣的創作者手續費流向、鏈上欄位與事件的讀法

在 pump.fun 上每買賣一次，除了平台的手續費，還有一筆付給這枚幣創作者的手續費。過去這筆錢進的是以創作者地址推導出來的金庫。2026 年 9 月 12 日，官方文件加入了一種新的幣，這筆錢改留給持有人。

本文照 pump.fun 在 GitHub 公開的程式文件讀這種「持有人獎勵幣」（倉庫 pump-fun/pump-public-docs，讀取時最後一次提交在 2026-10-13；〈Holder Rewards Coins〉一檔最後修改於 2026-09-14）。bonding curve 帳戶怎麼讀，見本站pump.fun 是什麼；畢業後的池子怎麼讀，見PumpSwap liquidity pool 怎麼讀。引號內的英文是文件原文，中文說明為本文轉述；標明「本文整理」的部分是我們把條文拼起來的讀法。

持有人獎勵幣是什麼

文件第一段就把差別講完了："On a holder rewards coin the creator fee that is charged on every trade is not paid to a creator wallet." 這筆創作者手續費照樣每筆交易都收，只是不進創作者的錢包，而是留給持有這枚幣的人，由 pump.fun 持續發放給他們。

文件同時說明這是一個向後相容的改動：沒有更新的整合程式照常運作，只是建立出來的會是一般的幣，也看不到新增的欄位。換句話說，一個沒升級的工具讀這類幣，不會出錯，但也不會告訴你它是持有人獎勵幣。

對創作者和持有人分別意味著什麼

文件在〈What changes for creators〉一節列了四點，整理如下：

• 一枚幣是哪一種，建立時就決定。 一般的幣之後可以透過社群接管轉成持有人獎勵幣，但反過來不行："a holder rewards coin can never go back to being a regular coin."
• 創作者沒有東西可領。 這類幣的創作者手續費歸持有人。
• 持有人什麼都不用做。 由 pump.fun 發放，文件寫明沒有給持有人呼叫的領取指令。
• 這個功能可以被整體關掉。 pump.fun 可以全域停用持有人獎勵幣的建立；停用期間，`create_v2` 會拒絕建立這類幣的請求。

第三點值得多看一眼。既然沒有領取指令，持有人錢包裡不會出現一筆「我去領獎勵」的交易；要確認獎勵有沒有發到，只能看發放方那一側的轉帳紀錄。發放的頻率與分配方式，以 pump.fun 的公告為準。

建立的時候：create_v2 多了一個參數

建立指令 `create_v2` 多了一個放在最後、可省略的參數 `is_holder_reward`，型別是 `OptionBool`。傳 `[true]` 建立持有人獎勵幣；省略或傳 `[false]` 就是一般的幣。因為是尾端的可選參數，舊程式組出來的指令資料仍能解碼，只會建立一般的幣。

最容易讀錯的是 `creator` 這一格。文件寫明，持有人獎勵幣不會把 `creator` 參數當成手續費收款人："the program records a pump.fun controlled address as the coin's creator instead." 也就是說，建立者照常傳自己的地址，但程式在帳戶裡記下的創作者，是一個由 pump.fun 控制的地址。

文件接著說，因此 `BondingCurve::creator` 這個欄位「仍然告訴你手續費去哪裡」，而 `buy`／`sell` 用到的 `creator_vault` 推導方式沒有改變。

本文整理：研究一枚幣時，如果看到 `creator` 不是發幣人的錢包，先不要急著下結論說「創作者換了人」或「有人接管」。它可能就是一枚持有人獎勵幣，手續費本來就不歸發幣人。判斷的依據應該是下面要講的 `is_holder_reward` 旗標，而不是 `creator` 地址看起來像誰。

TypeScript SDK 的對應參數是 `holderReward: true`。文件另外提到，在持有人獎勵幣被全域停用時，SDK 會事先丟出 `HolderRewardDisabledError`。

交易的時候：沒有任何指令改變

這一節文件只有一句重點："There are no changes to any trade instruction." `buy`、`sell`、`buy_v2`、`sell_v2`、`buy_exact_quote_in_v2`，以及 PumpSwap 的 `buy`／`sell`，對持有人獎勵幣使用相同的帳戶和相同的參數。手續費的計算方式也和以前一樣，唯一的差別是誰最後收到創作者手續費。

所以單看一筆交易的指令，分不出它買的是不是持有人獎勵幣。要分辨，得讀帳戶或事件。

帳戶欄位：is_holder_reward

兩個帳戶各多了一個布林欄位：

| 帳戶 | 新欄位 | 文件說明（本文轉述） | | --- | --- | --- | | `BondingCurve`（Pump） | `is_holder_reward` | 持有人獎勵幣為 `true`，加在既有欄位之後 | | `Pool`（PumpSwap，正規池） | `is_holder_reward` | 幣畢業時從 bonding curve 帶過來 |

舊帳戶的處理方式和其他尾端欄位一樣：在這個欄位出現之前寫入的帳戶短一個位元組，應該讀成 `false`。官方 SDK 的解碼函式兩種長度都能處理；自己寫解析器的，要記得先看帳戶長度。

本文整理：`Pool` 這一格標的是「正規池」（canonical）。同一枚幣可能有好幾個池，這件事在池帳戶那一篇講過；旗標從 bonding curve 帶到的是畢業時建立的那一個池。

事件：兩個新欄位，舊欄位照舊

文件列了四類事件的新欄位：

| 事件 | 新欄位 | 意思（本文轉述） | | --- | --- | --- | | `CreateEvent`（Pump） | `is_holder_reward` | 這枚幣建立時是不是持有人獎勵幣 | | `CreatePoolEvent`（PumpSwap） | `is_holder_reward` | 畢業時建立的池帶著同一個旗標 | | `TradeEvent`（Pump） | `holder_rewards_bps`、`holder_rewards` | 持有人獎勵幣這筆交易的創作者手續費率與金額；其他幣為 `0` | | `BuyEvent`／`SellEvent`（PumpSwap） | `holder_rewards_bps`、`holder_rewards` | 同上，用於 PumpSwap 的交易 |

另一句同樣重要：既有的 `creator_fee`、`creator_fee_basis_points`（Pump）和 `coin_creator_fee`、`coin_creator_fee_basis_points`（PumpSwap）欄位沒有改變，在持有人獎勵幣上也照樣回報手續費。文件的說法是，所以既有的索引程式不需要修改。

本文整理：這就是陷阱所在。如果你的統計是「把 `creator_fee` 加總，算出某個創作者賺了多少」，那麼持有人獎勵幣的這筆錢也會被算進去，但它其實沒有進創作者的口袋。要分開，就得同時讀 `is_holder_reward` 或 `holder_rewards`。新欄位出現之前的舊日誌比較短，缺的欄位讀成 `0`／`false`。

cashback 模式停用

同一份文件順帶宣布了另一件事：cashback 模式停用。`create_v2` 現在會拒絕 `is_cashback_enabled = [true]`，原文是 "no new cashback coins can be created"。建立時這個參數要傳 `[false]` 或省略。

已經存在的 cashback 幣不受影響：交易照常，它們的創作者手續費仍然以 cashback 的形式回給買方；已經累積的 cashback 仍可透過 `claim_cashback`／`claim_cashback_v2` 領取。

本文整理：到這裡，一枚 pump.fun 幣的創作者手續費有三種去向——一般幣歸創作者、cashback 幣回給買方、持有人獎勵幣歸持有人。研究紀錄裡只寫「創作者手續費 X」而不寫這枚幣是哪一種，日後回頭看就無法解讀。

社群接管：一般幣也能轉過去

文件最後一節說，以下兩種情況要聯絡 CTO（community takeover）團隊：一是更改 custom pair 上一枚幣的創作者手續費率（custom pair 指以 SOL 或 USDC 以外的資產計價的幣；SOL 與 USDC 計價的幣一律用標準費率表）；二是把一枚既有的幣轉成持有人獎勵幣。轉過去之後，就一直是持有人獎勵幣。

本文整理：這表示 `is_holder_reward` 不只在建立時才會變成 `true`。比對某枚幣前後兩次讀到的帳戶，如果旗標從 `false` 變成 `true`，最可能的解釋是發生了這種轉換；讀到的時間點要記下來。

創作者手續費的金庫怎麼來，另一份〈Pump Program Creator Fee Update〉寫了：`creator_vault` 是以 `creator-vault` 和 `BondingCurve::creator` 為種子推導出來的帳戶，所以 `creator` 記成哪個地址，手續費就進哪個金庫。本文整理：這也就是持有人獎勵幣要把 `creator` 記成 pump.fun 控制地址的原因。本文不抄任何費率數字，以讀取當下的鏈上設定為準。

研究紀錄要留哪幾格

• 幣的 mint、讀取時間，以及當下 `BondingCurve` 或正規 `Pool` 的 `is_holder_reward`。舊帳戶短一個位元組時，記成 `false` 並註明是依文件推定。
• `creator` 地址，另記一格說明它是發幣人錢包還是 pump.fun 控制的地址；不要用這一格判斷手續費歸誰。
• 統計創作者收入時，`creator_fee` 與 `holder_rewards` 分兩欄，不混加。
• 這枚幣是一般、cashback 還是持有人獎勵幣；如果前後讀到的旗標不同，記下兩次讀取的時間。
• 文件版本：倉庫的提交日期，以及〈Holder Rewards Coins〉一檔的修改日期。這類規則改動頻繁，日後回讀先看提交紀錄。

欄位讀不到值時該怎麼記，見本站代幣資料 API 回傳 null 或查不到。

持有人能分到多少、要持有多久、這類幣值不值得買，文件都不回答，本文也不回答。這一頁只說明鏈上欄位和事件怎麼讀，不構成任何交易建議。