FAQ
What is the Genesyum API?
The Genesyum API is a multi-chain backend platform that allows you to create, manage, and interact with tokens across multiple blockchain networks. It provides unified RESTful endpoints that abstract blockchain-specific complexities, returning serialized transactions for you to sign and submit on-chain. The platform supports advanced features such as metadata management, transfer fees, liquidity pools, token lockers, and authority controls across different blockchain ecosystems.
Which blockchains does the API support?
The API supports multiple blockchain networks including Solana, Base, Polygon, and Binance Smart Chain, with potential for additional chains. Each blockchain has its own token standards and characteristics, but the API provides a consistent interface for common operations across all supported networks.
What types of tokens can I create?
You can create fungible tokens using the native token standard of each blockchain. Each network has its own token standard with varying capabilities, transaction speeds, and fee structures. The API handles the blockchain-specific implementation details while providing you with a unified creation interface that supports features like metadata, optional transfer fees, and authority management.
How do token standards differ across blockchains?
Each blockchain uses different token standards with unique characteristics. Transaction speeds, fees, consensus mechanisms, and supported features vary by network. Some blockchains offer faster block times and lower fees, while others prioritize decentralization and security. The API abstracts these differences, allowing you to work with a consistent interface regardless of the underlying blockchain.
How do I create a new token?
To create a token, use the appropriate creation endpoint for your chosen blockchain. Provide required fields such as your wallet address, token name, symbol, decimals, supply, description, and an image file. The API returns a serialized transaction that you must sign with your wallet and submit to the blockchain network. Full details and language-specific examples are available in the API Reference section for each supported blockchain.
How can I update token metadata?
Use the metadata update endpoint to change a token's name, symbol, description, or image. The API automatically detects the blockchain and token version, ensuring you have the required authority. You must provide your wallet address, the token's mint address, and the new metadata values. The API returns a transaction for you to sign and submit.[^5][^2]
How do I burn tokens?
To burn tokens, use the token burn endpoint for your specific blockchain. Specify your wallet address, the amount to burn, the token's decimals, and ownership details. The API prepares a burn transaction for you to sign and submit to the network, permanently removing tokens from circulation.
Can I lock tokens for vesting or delayed release?
Yes. The API provides endpoints for locking tokens until a specified release date and for checking locker information. You'll provide your wallet address, the amount, decimals, and the release date. The API returns a transaction for locking the tokens, which is useful for vesting schedules, airdrops, or time-based token releases.
How do I manage token authorities?
You can revoke or manage token authorities such as minting, freezing, or metadata update permissions using the authority management endpoint. Pass the appropriate flags for each authority you wish to revoke, along with your wallet address and ownership details. Revoking authorities increases token security, builds trust, and promotes decentralization.
How do I use liquidity pools?
The API supports creating, adding liquidity to, and removing liquidity from pools on supported decentralized exchanges. You'll need to specify the relevant token addresses, amounts, and your wallet address. The API returns serialized transactions for each operation, enabling you to provide liquidity and facilitate token trading.
Can I collect transfer fees from my token?
Yes, if your token was created with transfer fee functionality enabled. Use the fee collection endpoint, specifying your wallet address and the accounts to withdraw from. The API prepares a fee collection transaction for you to sign and submit. This feature is particularly useful for creating sustainable tokenomics models.
How do I generate and use discount codes?
You can generate a discount code using the discount endpoint. This code provides percentage-based discounts and referral bonuses. Pass your wallet address and the desired code string. The API returns a transaction for you to sign and submit. Use these codes in supported endpoints to receive discounts on platform services.
How do I check the fee for a service?
Use the service fee endpoint, replacing the service parameter with the name of the operation you want to perform. The API returns the fee amount for that service, helping you estimate costs before executing transactions.
How can I verify if my transaction was successful?
After signing and submitting a transaction, use the transaction verification endpoint to check its status. The API will confirm whether the transaction is pending, successful, or failed on the blockchain network. Different blockchains have varying confirmation times and finality guarantees.
How do I retrieve a token's image or metadata?
The API provides endpoints to retrieve token images and full JSON metadata, including name, symbol, description, image URL, and custom attributes. This information is stored consistently across blockchains, ensuring your token maintains its identity regardless of the underlying network.
What should I do if I get an error or missing required fields?
Check the error message in the API response. Most endpoints return detailed messages if required fields are missing or validation errors occur. Ensure you provide all required parameters as specified in the blockchain-specific API Reference. Verify your request format and confirm that your wallet has sufficient permissions, authority, and native tokens for gas fees.
How do cross-chain tokens work?
Cross-chain token functionality allows tokens to exist and operate across multiple blockchain networks. The API can help facilitate cross-chain operations through specialized endpoints that handle the complexities of multi-chain token management, including supply governance and interoperability protocols.
What are the transaction speed and cost differences?
Transaction speeds and costs vary significantly across blockchains. Some networks offer sub-second block times with minimal fees, while others may have longer confirmation times but stronger decentralization guarantees. The API provides fee estimation and status checking endpoints to help you understand costs and timing for each supported blockchain.
Where can I learn more about blockchain tokens and best practices?
Explore the comprehensive learning resources in the Developer Resources & Guides section, which includes hands-on courses covering blockchain fundamentals, token economics, smart contract interactions, and security considerations across multiple blockchain ecosystems. These resources provide foundational knowledge for building confidently on any supported blockchain.
If you have further questions or need support, please refer to the API Reference sections or contact the platform maintainers.