For instant change notifications, join and subscribe to our Telegram channel: Bags Dev Notifications.
Get Token Claim Events - Time-Based Filtering:The New Parameters:
/fee-share/token/claim-events endpoint now supports two query modes:- Offset Mode (default, backward compatible): Use
mode=offsetwithlimitandoffsetfor traditional pagination. - Time Mode (new): Use
mode=timewithfromandtounix timestamps to retrieve all events within a specific time range.
mode: Query mode (offsetortime). Defaults tooffsetfor backward compatibility.from: Start unix timestamp (required for time mode).to: End unix timestamp (required for time mode, must be >=from).
- Updated Get Token Claim Events API reference with new parameters.
- Added Get Token Claim Events how-to guide with examples for both modes.
- Existing integrations using offset/limit without specifying
modewill continue to work unchanged.
Token Launch v2 - Fee Sharing Required:
- Token Launch v2 now requires fee sharing configuration for all token launches. Launches without shared fees are no longer supported.
- All fees must be explicitly allocated using basis points. Creators must always set their BPS explicitly, even when receiving 100% of fees.
- When sharing fees, both creators and fee claimers must have their BPS set explicitly in the configuration. New Features
- Multiple Fee Claimers: Support for sharing fees with multiple fee claimers (not just 2 users), up to a maximum of 100 fee earners per token launch (including the creator). Each fee claimer can be identified by social provider (twitter, kick, github) and username.
- Partner Configuration: New partner key system allows platforms and partnerships to receive fees from multiple token launches. See Create Partner Key and Claim Partner Fees guides.
- Lookup Tables (LUTs): Automatic LUT creation and management for fee share configs with more than 15 fee claimers. The SDK handles LUT creation, slot waiting, and extension automatically.
- Trade Service: New trade endpoints for getting quotes and executing token swaps. See Trade Tokens guide.
createBagsFeeShareConfignow supportspartnerandpartnerConfigparameters for partner fee sharing.createBagsFeeShareConfignow supportsadditionalLookupTablesparameter for configs with >15 fee claimers.- New
getConfigCreationLookupTableTransactions()helper function for LUT creation. - New
waitForSlotsToPass()utility function for waiting between LUT creation and extension. - New
getPartnerConfigCreationTransaction()for creating partner keys. - New
getPartnerConfigClaimTransactions()for claiming partner fees. - New
getQuote()andcreateSwapTransaction()for token trading. - Updated
getClaimTransaction()to returnTransaction[]instead ofVersionedTransaction[].
- Updated Launch a Token guide with v2 flow and multiple fee claimer support.
- Removed
launch-token-with-shared-feesguide (functionality merged into main launch guide). - Added Create Partner Key guide with dev dashboard and SDK methods.
- Added Claim Partner Fees guide with dev dashboard and SDK methods.
- Added Trade Tokens guide for swap functionality.
- Updated Claim Fees guide with new SDK functions and detailed position type explanations.
- Updated core principles: Program IDs (added Fee Share V2), Lookup Tables (LUT requirements), Tipping (updated endpoints), File Uploads (corrected endpoint).
- Token launches now require fee sharing configuration. The old flow without fee sharing is no longer supported.
- Fee claimers must be identified using supported social providers:
twitter,kick, andgithub. - Maximum of 100 fee earners (including the creator) per token launch.
Endpoint Updates (7-day deprecation):
/fee-share/wallet/v2replaces/fee-share/wallet/twitter(now supporting GitHub, Kick, TikTok, Twitter)./token-launch/creator/v3replaces/token-launch/creator/v2(response type includes more details).- Old endpoints will be removed in 7 days.
-
Optional tip support on launch-related endpoints. Add an optional tip using
tipWallet(Base58 encoded Solana public key) andtipLamports(lamports) on:
/token-launch/create-config,/token-launch/create-launch-transaction,/token-launch/fee-share/create-config. -
No mandatory IPFS upload for token info creation.
/token-launch/create-token-infonow acceptsimageUrland/ormetadataUrl. WhenmetadataUrlis provided, we skip IPFS upload and use the provided URL as-is. SDK v1.0.8: -
Adds
getLaunchWalletV2. -
getAllClaimablePositionsis more efficient, with newchunkSizearg to reduce RPC rate limits. - All downstream functions now support commitment.
- General performance & stability improvements.
- Total fees earned reporting is now more accurate.
- No more fees for token creation via API (only pay Solana tx cost).
- Better error responses across the board.
