{"id":"finance.souvenir/coins","slug":"finance-souvenir-coins","title":"Souvenir","description":"Souvenir prize coins on Solana: search coins and rounds, launch and trade coins, claim wins.","version":"1.3.0","publisher":{"kind":"domain","id":"souvenir.finance","label":"souvenir.finance","url":"https://souvenir.finance"},"website":"https://souvenir.finance/llms.txt","repository":"","remotes":[{"type":"streamable-http","url":"https://souvenir.finance/mcp"}],"packages":[],"published":"2026-11-13","updated":"2026-11-13","status":"online","auth":"","latency_ms":989,"checked":"2026-11-19","uptime":67,"checks":3,"tools":[{"name":"search_coins","title":"Search Souvenir coins","description":"Lists coins on Souvenir, searched and sorted. Answers { coins, nextCursor }. Each coin: mint, symbol, name, image, venue (pump, meteora or bags), origin (launched on Souvenir or brought), mode (full: its rounds draw an item; draws: they pay drawSol in SOL; prizes: its creator awards prizes; redeem: no draws; holders burn coins for its one prize), potSol (the open pot), prize (full and redeem modes","read_only":true},{"name":"get_coin","title":"Get a Souvenir coin","description":"One coin by its mint address, as search_coins lists it: mint, symbol, name, image, venue (pump, meteora or bags), origin (launched on Souvenir or brought), mode (full: its rounds draw an item; draws: they pay drawSol in SOL; prizes: its creator awards prizes; redeem: no draws; holders burn coins for its one prize), potSol (the open pot), prize (full and redeem modes: id, image, priceUsd), round (t","read_only":true},{"name":"get_rounds","title":"Get a coin's rounds","description":"A coin's rounds, newest first, 50 a page. Answers { rounds, next }; each round: number, state, prize, winner, drawnAt, deliveredAt, paidSol (SOL paid to the winner, else null). For older rounds, pass next back as cursor; it is null on the last page.","read_only":true},{"name":"get_round","title":"Get one round with its proof","description":"One round in full: { round } with its mode, target and pot, its state in words (stateText), and its proof: the holder snapshot's slot, the ticket total, the Merkle root, the drand round and randomness, and the winning ticket (SHA-256 of the randomness, as a number, modulo the total). A prize the creator awarded has proof { awardedBy: \"creator\" }; a round a holder redeemed by burning coins has proo","read_only":true},{"name":"sign_in_challenge","title":"Start signing in with a wallet","description":"The first step of launching: { id, message, expiresAt } for your Solana wallet. Sign message (its UTF-8 bytes) with the wallet's ed25519 key and give id and the signature (base64) to sign_in within 5 minutes. Signing it authorizes no transaction or transfer. Launching a coin, in order: (1) sign_in_challenge with your wallet's address, sign its message with that wallet, then sign_in for a token; (2","read_only":false},{"name":"sign_in","title":"Finish signing in","description":"The signed challenge: { token, wallet, expiresAt }, a token for an hour (then sign in again) that the launch tools take as token, or that the request sends as Authorization: Bearer <token>. Launching a coin, in order: (1) sign_in_challenge with your wallet's address, sign its message with that wallet, then sign_in for a token; (2) launch_options, and search_prizes for the prize (or shopper_sample ","read_only":false},{"name":"launch_options","title":"What a launch takes now","description":"What launching takes now for your wallet, as the site's launch form reads it: allowed and its reason, venues (meteora: Souvenir's own curve; pump: pump.fun), feeLevels and shareLevels in basis points, defaults, tickets (the ticket rules), holdHours, which prize kinds are open, basket, pump (pump.fun's fees; on BTC pairs its feeLevels, and shield and devBuy: whether the launch shield and a dev buy ","read_only":true},{"name":"search_prizes","title":"Search the prizes a coin can launch with","description":"Prizes a coin can be launched with now, from Souvenir's catalogue: { prizes, total, next }. Each prize: id (what prepare_launch takes as skin), title, kind, priceUsd, from (true: a family priced from its smallest, which id names), image, and store, sizes or note when it has them. For the next page, pass next back as offset; it is null on the last page. No sign-in needed. CS2 skins are not listed h","read_only":true},{"name":"shopper_sample","title":"A shopper coin's sample pick","description":"For a shopper coin, one that picks its own prizes: what a shopper with this brief and price band would start with, as the site's launch form asks it: { id, prize: { name, title, image, priceUsd, store }, why, count }. The brief is a line or two of taste (\"the strangest thing you can find\"); the band is the cheapest and dearest price in dollars (the cheapest at least launch_options curator.minUsd, ","read_only":false},{"name":"prepare_launch","title":"Prepare a coin's launch","description":"Prepares your launch, as the site's launch form does (the same checks, fees and rules): stores the picture and the coin's metadata and answers { mint, transaction, summary }, the transaction base64 for your wallet to sign (a pump.fun launch adds venue and transactions, the same one in a list). Sign it with your wallet without sending it and give it to submit_launch within the hour. The picture is ","read_only":false},{"name":"submit_launch","title":"Send a signed launch","description":"Your wallet's signed launch: Souvenir checks it is the prepared one (your wallet may only add its compute budget or guard instructions), adds the coin's own signature and sends it. Answers { signature }. Then launch_status. Takes the token from sign_in, as token or as the request's Authorization: Bearer header. Refused with \"Launching through the API is not open yet.\" (403 not_open) only if Souven","read_only":false},{"name":"launch_status","title":"Follow a launch","description":"Where your launch stands, as the site's page follows it: { status, mint } with status pending (ask again in a few seconds), split (a pump.fun launch landed: transaction is the second approval, the split of its creator fee, for your wallet to sign; then submit_split), confirmed (the coin is on Souvenir) or failed (with reason). Takes the token from sign_in, as token or as the request's Authorizatio","read_only":false},{"name":"submit_split","title":"Approve a pump.fun launch's split","description":"The split launch_status handed over, approved by your wallet: either the signature of the transaction your wallet signed and sent itself, or the signed transaction (base64) for Souvenir to send. Answers { signature }. Then launch_status until confirmed. Takes the token from sign_in, as token or as the request's Authorization: Bearer header. Refused with \"Launching through the API is not open yet.\"","read_only":false},{"name":"quote_trade","title":"Quote a trade","description":"What a buy or a sell of a Souvenir coin gives now, as the coin's page quotes it: { out, minOut, feeLamports, partial, venue }. out and minOut are the coin's raw units for a buy, lamports for a sell; minOut is the least you get at slippageBps. feeLamports is the trading fee (null on a pump.fun coin, where pump.fun takes it); partial, a buy larger than the curve has left (spent and refund say how mu","read_only":true},{"name":"build_trade","title":"Build a trade for your wallet","description":"The trade's transaction for your wallet to sign, as the coin's page builds it: { transaction, out, minOut }, the transaction base64 (unsigned, version 0, paid by your wallet). It changes nothing until your wallet signs it and it is sent. A coin paired with $SOUVENIR (get_coin's pair) trades in SOL the same way: one transaction swaps through $SOUVENIR, and keepsSouv, a little $SOUVENIR, stays in yo","read_only":true},{"name":"send_transaction","title":"Send a signed transaction","description":"Sends a transaction your wallet signed (base64, every signature in place) to Solana, as the site sends what a wallet signs: { signature }. Only one Souvenir built for you in the last few minutes (build_trade, or prepare_launch's devSwap or souvSwap), signed as it was built; any other is refused (not_built): send it through a Solana RPC. A trade can't be undone once it lands. With no answer from th","read_only":false},{"name":"request_trade","title":"Ask a person to approve a trade","description":"For an agent helping a person who holds their own wallet: a link (url) for them to open, see this trade with a fresh quote, and approve it with their own wallet on souvenir.finance. Answers { id, url, state, expiresAt, side, amount, slippageBps, coin, quote }: quote is what the trade gives now (out, minOut, feeLamports, partial, venue), and the page quotes again when it is opened. Show the person ","read_only":false},{"name":"trade_request","title":"Read an approval link","description":"How an approval link from request_trade stands: { id, url, state, expiresAt, side, amount, slippageBps, coin, wallet, signature, out }. state: open (waiting for the person), sent (they approved and the trade is on its way to Solana), confirmed (it landed: signature is the transaction, wallet the one that traded), failed (it landed and failed on chain), dropped (the network dropped it, so it never ","read_only":true},{"name":"my_wins","title":"Your wins","description":"Your wallet's wins, as the site's prizes page reads them: { wins, link, evmAddress }, the newest first. Each win: mint, symbol, number (its round), skin (the prize), state (drawn: waiting for you; buying, sent, delivered; owed_sol, paid_sol; forfeited), stateText, linkDeadline (claim by then), keep (the coins you must still hold to claim, raw units), and its kind's details (goods, gift, stars, tri","read_only":true},{"name":"claim_sol","title":"Take a win's SOL instead","description":"Takes a won prize's SOL instead of the prize now, as the prizes page does, through the site's own route for that kind of prize: its share of the prize's worth (my_wins solOffer: 75% for a skin or a case, 66% for most others, 60% for a store's piece), or an xStocks prize's full worth. Paid to your wallet within minutes. Final: the prize can't be claimed after. Only while the win waits for you and o","read_only":false},{"name":"recent_wins","title":"Recent winners","description":"The latest wins on Souvenir, newest first, as the site's Recent winners lists them: { wins }, each with mint, symbol, coinImage, skin (the prize), skinImage, winner, winnerShort, round, at, state, ordered, claimRule, lastCall, solLamports (a last call's SOL), offer and worthUsd. Wins of adult (NSFW) prizes are left out, as on the site, unless nsfw is true: from the latest 200, so a page may hold f","read_only":true},{"name":"get_holders","title":"Get a coin's holders","description":"A coin's holders now, as its page shows them: { slot, total, streak, holdHours, holders }, the 50 with the most draw tickets: owner, amount (the coins held now, raw units), tickets, multiplier (1 to 2 with holding streaks, to 3 with staked coins), odds (of its next draw, 0 to 1; null on a redeem coin, which never draws) and locked (staked coins, raw) when there are any. Its pools, Souvenir's own w","read_only":true},{"name":"create_coin_key","title":"Make a coin key","description":"A coin key for the coins your wallet created, as the coin page's Developers dialog makes one: { key, id, webhookSecret, view }. The key (ck_live_…) and the webhook secret are shown this once: keep them. It works for set_coin_mode and award_prize and the coin API (souvenir.finance/api/v2/openapi.json), on every coin the wallet created. At most 5 live keys a wallet; revoke one with revoke_coin_key (","read_only":false},{"name":"revoke_coin_key","title":"Revoke a coin key","description":"Ends one of your coin keys now, as the coin page's Developers dialog does: { ok }. It is refused from then on and its webhook stops; it can't be made live again. id is the key's id, as create_coin_key answered it (GET /api/v2/me/coinkeys lists your keys with their ids). Works whatever the coin API's switch, so a leaked key can always be ended. 404 for an id that is not one of your live keys. Takes","read_only":false},{"name":"set_coin_mode","title":"Set your coin's mode","description":"Your coin's mode from its next round (the round filling keeps its own): full (its rounds draw its prize), draws (each round pays drawSol in SOL to its winner), prizes (you give prizes from its pot with award_prize; only a coin nobody but you holds can switch to it, has_holders otherwise) or redeem (no draws: the pot pays for redemptions, and a holder burns enough coins for its one prize, a store i","read_only":false},{"name":"award_prize","title":"Award a prize from your coin's pot","description":"A coin in prizes mode: gives winner an item, bought now from the coin's open pot at its fresh price plus a round's margin, as a round of the coin's: { round }. item is an id from search_prizes. The same idempotencyKey again answers the same round, whatever changed since. Refused when the pot is short, the item can't be bought now, or the winner is one of the coin's pools, Souvenir's wallets or its","read_only":false}],"server_info":{"name":"souvenir","title":"Souvenir","version":"1.5.0"},"category":"web-search","tags":["crypto","ecommerce"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-10","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/finance-souvenir-coins/"}