Megapot API
Megapot API
This helper API allows for quick access to jackpot data. It's useful for anyone adding our jackpot to their site, offering tickets as an incentive, or launching a custom jackpot in their token.
API Key
To use the Megapot API, you will need an API key. Get one by contacting us on our Developer Telegram.
Usage
Simply attach the API key to your url params or in a request header for access to the below endpoints.
URL Params
An easy to use method which allows you to append the api key to your request URL using ?apikey=<your api key>
Example: https://api.megapot.io/api/v1/jackpot-round-stats/active?apikey=<your api key>
Request Headers
You can also add your api key to your client's request headers. This is the preferred method as it will keep the api key out of your url and most logging services.
Use the header apikey: <your api key> for these requests. See the Axios example below:
axios.get('https://api.megapot.io/api/v1/jackpot-round-stats/active', {
headers: {'apikey': 'your api key'},
});Endpoints
Current jackpot info: Get the current Megapot prize pool, end time, and more. Highly performant.
User ticket history: Get all of a user's Megapot ticket purchases
Guaranteed Daily Prize history: Get all of a user's Megapot USDC giveaway history
Jackpot info: Get all info for a given jackpot contract
Jackpot history: Get all ticket purchases and wins for a given jackpot contract
Active Jackpot Stats
https://api.megapot.io/api/v1/jackpot-round-stats/active
Retrieve stats about the active Megapot jackpot round. Highly performant since we cache this data and update it per minute.
{
"prizeUsd": "1005045.74",
"endTimestamp": "1748541293000",
"oddsPerTicket": "1435780",
"ticketPrice": 1000000,
"ticketsSoldCount": 13,
"lastTicketPurchaseBlockNumber": 30833334,
"lastTicketPurchaseCount": 1,
"lastTicketPurchaseTimestamp": "1748456015000",
"lastTicketPurchaseTxHash": "0x277fa1121692019f4277d3b45900746b067ce4a5218d19649a1509733cc4a8ab",
"lpPoolTotalBps": "1005045743901",
"userPoolTotalBps": "9100000",
"feeBps": 3000,
"referralFeeBps": 1000,
"activeLps": 235,
"activePlayers": 9,
}Response Data
prizeUsd: The amount in USDC of the current jackpot prize pool.
endTimestamp: At what time the jackpot is able to be run. NOTE The jackpot is ran manually through cron jobs, the exact time may differ. This time is when the contract will allow the jackpot to be processed.
oddsPerTicket: This is the odds a single ticket will win. 1 in oddsPerTicket. You can divide this number by the amount of tickets purchased to get the odds for all tickets purchased by a user.
ticketPrice: The amount in Szabo units. USDC uses 6 decimals, 1_000_000 is the same as 1 USDC.
ticketsSoldCount: Amount of tickets purchased by users so far this round.
lastTicketPurchaseBlockNumber: Block number of the latest ticket purchase.
lastTicketPurchaseCount: Amount of tickets purchased in the latest ticket purchase.
lastTicketPurchaseTimestamp: Timestamp of the latest ticket purchase.
lastTicketPurchaseTxHash: Transaction hash of the latest ticket purchase.
lpPoolTotalBps: The amount of USDC in Szabo units of the current jackpot. prizeUsd is derived from this value (prizeUsd / 10 ** 6)
userPoolTotalBps: The amount of USDC in Szabo units from ticket purchases this round.
feeBps: The amount of fees in basis points taken from each ticket sale to pay LPs/Referrers.
referralFeeBps: The amount of fees in basis points a referrer will earn per ticket sale. If a ticket purchase is referred, a value of 1000 means 10% goes to the referrer and 20% to the LPs. The LP fees is determined by the feeBps - referralFeeBps.
activeLps: The amount of LPs wallets currently active this round.
activePlayers: Unique player wallets currently active this round.
User Ticket History
https://api.megapot.io/api/v1/contracts/0xbEDd4F2beBE9E3E636161E644759f3cbe3d51B95/{walletAddress}
Get a user's ticket purchases for the Megapot Jackpot
[
{
"recipient": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"referrer": "0x898a26a26f3d8ca5df65d85fcf15cce33af89766",
"buyer": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"transactionHash": "0xb633e0b22d66faf0ddd430201485dbbe09f926233c594536d25e2d2f5d96c1bf",
"blockNumber": 27162323,
"ticketsPurchasedTotalBps": 7000,
"ticketsPurchased": 1
},
{
"recipient": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"referrer": "0x898a26a26f3d8ca5df65d85fcf15cce33af89766",
"buyer": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"transactionHash": "0xff36d67d7a0d0c2fb2b177d5cf492c53b30fe8838c860883151610845a989b3e",
"blockNumber": 27162362,
"ticketsPurchasedTotalBps": 7000,
"ticketsPurchased": 1
},
{
"recipient": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"referrer": "0x0000000000000000000000000000000000000000",
"buyer": "0x2a5f9443719899537fa51f5061cba8c8096719d2",
"transactionHash": "0x38e252f4c1fdd2bb0fecce7fa4d8dfbefa8669db675116d2040426e6629c8896",
"blockNumber": 27454909,
"ticketsPurchasedTotalBps": 7000,
"ticketsPurchased": 1
}
]Guaranteed Daily Prizes History
https://api.megapot.io/api/v1/giveaways/daily-giveaway-winners/{walletAddress}
Get a user's giveaway win history for our Guaranteed Daily Prizes
{
"0": {
"jackpotRoundId": 110,
"claimTransactionHashes": [
"0x8f683990c254e11727dfe025304bab4bdda1b65676454003d9e83ad2c94c8002",
"0xd73e5dc755e902cd41f063379366cdc14bf837e6475af2ad697a65d7a77113cc"
],
"claimedAt": "2025-06-18T22:15:19.408Z",
"drawingBlockNumber": 31739969,
"prizeValueTotal": 4
},
"1": {
"jackpotRoundId": 109,
"claimTransactionHashes": [
"0x44cbd3cdc51413a2d480e5fb01db865427ed541e4fb1633833b51fa73da77c0d"
],
"claimedAt": "2025-06-18T16:40:11.035Z",
"drawingBlockNumber": 31653571,
"prizeValueTotal": 2
}
}Jackpot Info
https://api.megapot.io/api/v1/contracts/{contractAddress}
Get current jackpot data for a given contract address. This is slower than the active jackpot stats API, as this one fetches it live from the contract on your behalf.
{
"data": {
"address": "0xbEDd4F2beBE9E3E636161E644759f3cbe3d51B95",
"result": {
"allFeesTotal": "109500000",
"allowPurchasing": true,
"entropyCallbackLock": false,
"fallbackWinner": "0x2a5f9443719899537Fa51f5061cBA8c8096719d2",
"feeBps": 3000,
"getJackpotFee": "32406457200001",
"jackpotLock": false,
"lastJackpotEndTime": 1744823661,
"lastWinnerAddress": "0x0000000000000000000000000000000000000000",
"lpFeesTotal": "91900031",
"lpLimit": 200,
"lpPoolCap": "1",
"lpPoolTotal": "353254604424",
"minLpDeposit": "250000000",
"owner": "0xF417533b9885E106dAe3336568D3823bA474CB88",
"pendingOwner": "0x0000000000000000000000000000000000000000",
"protocolFeeAddress": "0x0000000000000000000000000000000000000000",
"protocolFeeClaimable": "0",
"protocolFeeThreshold": "10000000000",
"referralFeeBps": 1000,
"referralFeesTotal": "17600000",
"roundDurationInSeconds": 86280,
"ticketCountTotalBps": 2555000,
"ticketPrice": "1000000",
"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"tokenDecimals": 6,
"userLimit": 1500,
"userPoolTotal": "255500000"
}
}
}Jackpot History
https://api.megapot.io/api/v1/contracts/{contractAddress}/jackpot-history
Get jackpot & ticket purchase history for a given contract address
[
{
"jackpot": {
"blockNumberStart": 29103514,
"blockNumberEnd": 29146710,
"time": "1745082767",
"winningTicket": "577773086",
"winAmount": "371234149839",
"txHash": "0x47b64953edb8248ac3f3529f20b1c1e462f3be4d49494ed7804f6a0b58dbe89c",
"ticketPurchasedTotalBps": 2744000,
"ticketPurchasedCount": 392
},
"ticketPurchases": [
{
"blockNumber": 29103607,
"recipient": "0x8d1135a82837e61aad796d8ff358bd07587751e3",
"referrer": "0x0000000000000000000000000000000000000000",
"buyer": "0x8d1135a82837e61aad796d8ff358bd07587751e3",
"ticketsPurchasedTotalBps": 7000,
"txHash": "0x18d0fc5a6115da92698430aa657ac4c180a05bdeac68aaaf9e89c4dadac04636"
},
{
"blockNumber": 29103691,
"recipient": "0x5ec4bde8ba38fb02e15acf711474a529b31e4e5a",
"referrer": "0x0000000000000000000000000000000000000000",
"buyer": "0x9bd9caf29b76e98d57fc3a228a39c7efe8ca0eaf",
"ticketsPurchasedTotalBps": 7000,
"txHash": "0x081257d1a564ea9fc4e53f7d9fe4e0ad6619bb5ca8a00dff106b9b6b32d88a3e"
}
]
}
]Last updated