Server definition
- Hash
- sha256:763a8041597f6871c938c949f07962a5e0aeb6370b1b20057a973ef963eb9336
- What it is
- What a remote MCP server returned when asked what it offers: 26 tools
The blob, as servednamed by its sha256
{
"instructions": "Souvenir (souvenir.finance) is a Solana app where every coin is paired with a prize. Part of each trade's fee goes to the coin's prize pot; when the pot covers the prize, a round closes and one holder is drawn with public drand randomness. Start with search_coins; get_coin, get_rounds and get_round take a coin's mint address. SOL amounts are strings with nine decimals, times are unix milliseconds. These reads are read-only and need no sign-in. An agent with its own Solana wallet can also launch a coin, while launching through the API is open to it: sign_in_challenge, sign its message with the wallet, sign_in; launch_options and search_prizes; prepare_launch; sign the transaction it answers with the wallet and submit_launch; launch_status until confirmed, and when it hands over a split to approve, sign it and submit_split. Souvenir never needs the wallet's private key. To trade a coin: quote_trade, build_trade with the wallet's address, sign the transaction with the wallet, send_transaction. An agent helping a person, which can't sign with their wallet, asks for the trade with request_trade, shows the person the link it answers to approve with their own wallet, and reads how it ended with trade_request. With the same sign-in, my_wins lists the wallet's wins and claim_sol takes a win's SOL instead. recent_wins and get_holders read who won and who holds. A coin's creator makes a coin key with create_coin_key for set_coin_mode and award_prize, and ends one with revoke_coin_key.",
"tools": [
{
"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 creator. Takes a coin key from create_coin_key as coinKey or as the request's Authorization: Bearer ck_live_… header; it works for every coin its wallet created. Refused with \"The coin API's keys and writes are not open yet.\" while they are not open.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coinKey": {
"description": "Your coin key (ck_live_…, from create_coin_key). Not needed when the request sends it as Authorization: Bearer ck_live_….",
"type": "string"
},
"idempotencyKey": {
"description": "Your own id for this award, 1 to 100 letters, digits or symbols: sent again, the same round answers.",
"maxLength": 100,
"type": "string"
},
"item": {
"description": "The prize: an id from search_prizes.",
"maxLength": 200,
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"winner": {
"description": "The wallet that wins it (base58).",
"type": "string"
}
},
"required": [
"mint",
"winner",
"item",
"idempotencyKey"
],
"type": "object"
},
"name": "award_prize",
"outputSchema": null
},
{
"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 your wallet. pay: 'souvenir' trades it in $SOUVENIR you hold instead: the amount of a buy, and out and minOut of a sell, are then raw $SOUVENIR (6 decimals). Trading a coin, in order: (1) quote_trade to see what you would get; (2) build_trade with your wallet's address; (3) sign the transaction it answers with your wallet; (4) send_transaction, or send it yourself through any Solana RPC. No sign-in: your wallet's signature is the approval, and Souvenir never needs its private key. The same fees and limits as the coin's page on souvenir.finance. An agent helping a person, which can't sign with their wallet, uses request_trade instead and gives them the link to approve it with their own wallet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "What you give, in whole units, as a string: lamports for a buy (1 SOL is 1000000000), the coin's raw units for a sell (Souvenir's and pump.fun's coins have 6 decimals: 1 coin is 1000000). With pay souvenir, a buy's is raw $SOUVENIR (6 decimals).",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"pay": {
"description": "What a coin paired with $SOUVENIR is paid in (a sell: what it receives): sol, the default, or souvenir. Any other coin takes sol only.",
"enum": [
"sol",
"souvenir"
],
"type": "string"
},
"side": {
"description": "buy: spend SOL for the coin. sell: the coin for SOL. With pay souvenir, $SOUVENIR in place of SOL.",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"slippageBps": {
"default": 300,
"description": "The most the price may move against you before the trade refuses, in basis points (300 is 3%, the site's default).",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"wallet": {
"description": "Your Solana wallet's address (base58): it pays, signs and receives.",
"type": "string"
}
},
"required": [
"mint",
"side",
"amount",
"wallet"
],
"type": "object"
},
"name": "build_trade",
"outputSchema": null
},
{
"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 only where the site offers it; hold to claim applies (your wallet must still hold 90% of the coins that counted for the win). Answers { ok } (and bps, the share). Takes the token from sign_in (sign_in_challenge with your wallet's address, sign its message with the wallet, sign_in), as token or as the request's Authorization: Bearer header. Refused with \"Wins through the API are not open yet.\" while they are not open to your wallet, as launching is.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"country": {
"description": "Where you are, optional (a physical item: it shows Souvenir where to ship next).",
"pattern": "^[A-Za-z]{2}$",
"type": "string"
},
"mint": {
"description": "The coin the prize was won on (a win's mint in my_wins).",
"maxLength": 60,
"type": "string"
},
"round": {
"description": "The round it was won in (a win's number in my_wins).",
"minimum": 1,
"type": "integer"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"required": [
"mint",
"round"
],
"type": "object"
},
"name": "claim_sol",
"outputSchema": null
},
{
"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 (or DELETE /api/v2/me/coinkeys/{id}, or on the coin's page). Only a coin's creator makes keys. Takes the token from sign_in, as token or as the request's Authorization: Bearer header. Refused with \"Coin keys are not open yet.\" while the coin API's keys are not open.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"name": {
"description": "A name for the key, 1 to 60 characters.",
"maxLength": 60,
"type": "string"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
},
"webhookUrl": {
"description": "Optional: an https address on a public host that gets a signed POST for each step of your coins' rounds.",
"maxLength": 300,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_coin_key",
"outputSchema": null
},
{
"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), potSol (the open pot), prize (full mode: id, image, priceUsd), round (the latest unfinished one: number, state, targetSol, potSol), holders (at the latest snapshot), links and pair ({ symbol, mint, solPerSouv } on a coin that trades against $SOUVENIR, else null). A coin that is not on Souvenir is not found.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "get_coin",
"outputSchema": null
},
{
"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) and locked (staked coins, raw) when there are any. Its pools, Souvenir's own wallets and the coin's creator are left out: they never win its draws. total is every ticket counted.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "get_holders",
"outputSchema": null
},
{
"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 not drawn yet has none.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"number": {
"description": "The round's number.",
"minimum": 1,
"type": "integer"
}
},
"required": [
"mint",
"number"
],
"type": "object"
},
"name": "get_round",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The last page's next.",
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "get_rounds",
"outputSchema": null
},
{
"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 are open to you), souv (coins paired with $SOUVENIR: on, whether they are open to your wallet now; feeLevels and defaultFeeBps; heldSouv, maxFirstBuySouv and raiseSouv in raw $SOUVENIR; solPerSouv) and more. 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.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"type": "object"
},
"name": "launch_options",
"outputSchema": null
},
{
"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 Authorization: Bearer header. Refused with \"Launching through the API is not open yet.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"signature": {
"description": "The signature submit_launch answered; without it, the one Souvenir recorded.",
"type": "string"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "launch_status",
"outputSchema": null
},
{
"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, trip, stock, nft, evm, offer, pack). solOffer, when not null, is what claim_sol pays: bps of its worth, and lamports. An xStocks prize (stock) not claimed yet can be taken at its full worth in SOL. Every other claim (a shipping address, a gift card's code, a Steam trade link, a hotel) is on souvenir.finance/prizes. Takes the token from sign_in (sign_in_challenge with your wallet's address, sign its message with the wallet, sign_in), as token or as the request's Authorization: Bearer header. Refused with \"Wins through the API are not open yet.\" while they are not open to your wallet, as launching is.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"type": "object"
},
"name": "my_wins",
"outputSchema": null
},
{
"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 imageUrl: an https address on a public host, fetched once, held to the site's picture rules (png, jpg, gif or webp, at most 4 MB). A coin with a prize names one: skin (an id from search_prizes), case, or basket (2 to 10 ids). With a dev buy your wallet's WBTC does not cover, it answers devSwap instead: sign its transaction and send it (send_transaction, or any Solana RPC), then prepare_launch again with devBuySats as given. pair: 'souvenir' makes the coin trade against $SOUVENIR instead of SOL, on Souvenir's own curve, while launch_options says souv.on; its first buy, if any, is firstBuySouv, raw $SOUVENIR from your wallet. On such a coin a first buy written in SOL is paid in $SOUVENIR: when your wallet lacks it, prepare_launch answers souvSwap instead. Sign its transaction, send it (send_transaction, or any Solana RPC) and wait until it is confirmed, then call prepare_launch again with the same arguments plus firstBuySouv set to souvSwap.target. If it answers souvSwap again with the same held, the swap is not in Souvenir's read yet: wait and ask again, and do not sign that one. 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.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"bannerUrl": {
"description": "A banner for the top of its page, optional: https; png, jpg or webp, at most 3 MB, three times as wide as tall, at least 600 px wide.",
"type": "string"
},
"basket": {
"description": "A basket of prizes instead: round 1 draws the first, each draw picks the next.",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
},
"basketOdds": {
"description": "Each basket prize's chance in whole percents, in the basket's order (equal without).",
"items": {
"type": "integer"
},
"type": "array"
},
"case": {
"description": "One of Souvenir's cases instead, <id>@<version>.",
"type": "string"
},
"charity": {
"description": "A charity coin: { address, name, url?, pledgeBps?, rounds?, ship?, variant? }, as the site's form sends it.",
"type": "object"
},
"curator": {
"additionalProperties": false,
"description": "A shopper instead: the id of a sample pick this wallet asked for (shopper_sample). The coin picks each round’s prize itself from the sample’s brief and price band; round 1’s prize is the sample’s. Send nothing else in it.",
"properties": {
"sample": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
}
},
"required": [
"sample"
],
"type": "object"
},
"description": {
"maxLength": 500,
"type": "string"
},
"devBuyLamports": {
"description": "A dev buy on a BTC pump.fun launch, in lamports, while launch_options says pump.devBuy.on.",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"devBuySats": {
"description": "The devSwap's devSats, given back once its swap landed.",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"feeBps": {
"description": "The trading fee in basis points (meteora); on a BTC pump.fun launch, its creator fee, one of launch_options pump.feeLevels.",
"enum": [
100,
150,
200,
250,
300,
350,
400,
450,
500,
550,
600,
650,
700,
750,
800,
850,
900,
950,
1000
],
"type": "integer"
},
"firstBuyLamports": {
"description": "A first buy in lamports (Souvenir's curve, or a SOL pump.fun launch).",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"firstBuySouv": {
"description": "A first buy on a coin paired with $SOUVENIR, in raw $SOUVENIR (6 decimals) from your wallet, at most launch_options souv.maxFirstBuySouv. With firstBuyLamports it is the target souvSwap answered, sent again.",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"holdHours": {
"description": "How long a coin must be held before it counts in a draw.",
"enum": [
0,
1,
6,
24
],
"type": "integer"
},
"imageUrl": {
"description": "The coin's picture: an https address on a public host; png, jpg, gif or webp, at most 4 MB.",
"type": "string"
},
"ladder": {
"description": "A prize ladder instead: 2 to 10 places in order, 1st first, each its own winner at every draw (each worth no more than the place above).",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 2,
"type": "array"
},
"launchWindow": {
"description": "meteora: the fee starts at 50% and falls to the coin's over 60 seconds.",
"type": "boolean"
},
"links": {
"additionalProperties": false,
"description": "https links; without a website, the coin's Souvenir page.",
"properties": {
"telegram": {
"type": "string"
},
"website": {
"type": "string"
},
"x": {
"type": "string"
}
},
"type": "object"
},
"name": {
"description": "The coin's name.",
"maxLength": 32,
"minLength": 1,
"type": "string"
},
"pair": {
"default": "sol",
"description": "What the coin trades against: sol, or souvenir ($SOUVENIR) on Souvenir's own curve while launch_options says souv.on.",
"enum": [
"sol",
"souvenir"
],
"type": "string"
},
"shareBps": {
"description": "The fee's share for the prize pot, in basis points (7500 by default on the site); 0 is a coin with no prize.",
"enum": [
0,
500,
1000,
1500,
2000,
2500,
3000,
3500,
4000,
4500,
5000,
5500,
6000,
6500,
7000,
7500,
8000,
8500,
9000,
9500,
10000
],
"type": "integer"
},
"shield": {
"description": "The launch shield, on a BTC pump.fun launch while launch_options says pump.shield.on.",
"type": "boolean"
},
"skin": {
"description": "The prize: an id from search_prizes, or a CS2 skin's market name.",
"type": "string"
},
"slippageBps": {
"default": 500,
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"staking": {
"description": "Staking open from the start.",
"type": "boolean"
},
"symbol": {
"description": "Its ticker: letters and digits.",
"maxLength": 10,
"minLength": 1,
"pattern": "^[A-Za-z0-9$]+$",
"type": "string"
},
"tickets": {
"additionalProperties": false,
"description": "How a holder's balance turns into draw tickets; without it, capped at 3% of the supply a wallet.",
"properties": {
"capPct": {
"enum": [
1,
2,
3,
5
],
"type": "number"
},
"curve": {
"enum": [
"standard",
"cap",
"soft",
"sqrt"
],
"type": "string"
},
"minPct": {
"enum": [
0.001,
0.01,
0.1
],
"type": "number"
}
},
"type": "object"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
},
"venue": {
"default": "meteora",
"description": "meteora: Souvenir's own curve (it needs feeBps). pump: pump.fun, while launch_options says venues.pump.",
"enum": [
"meteora",
"pump"
],
"type": "string"
},
"volatility": {
"description": "meteora: Meteora's dynamic fee on top of the base fee.",
"type": "boolean"
}
},
"required": [
"name",
"symbol",
"imageUrl",
"shareBps"
],
"type": "object"
},
"name": "prepare_launch",
"outputSchema": null
},
{
"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 much goes in). 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 your wallet. pay: 'souvenir' trades it in $SOUVENIR you hold instead: the amount of a buy, and out and minOut of a sell, are then raw $SOUVENIR (6 decimals). Trading a coin, in order: (1) quote_trade to see what you would get; (2) build_trade with your wallet's address; (3) sign the transaction it answers with your wallet; (4) send_transaction, or send it yourself through any Solana RPC. No sign-in: your wallet's signature is the approval, and Souvenir never needs its private key. The same fees and limits as the coin's page on souvenir.finance. An agent helping a person, which can't sign with their wallet, uses request_trade instead and gives them the link to approve it with their own wallet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "What you give, in whole units, as a string: lamports for a buy (1 SOL is 1000000000), the coin's raw units for a sell (Souvenir's and pump.fun's coins have 6 decimals: 1 coin is 1000000). With pay souvenir, a buy's is raw $SOUVENIR (6 decimals).",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"pay": {
"description": "What a coin paired with $SOUVENIR is paid in (a sell: what it receives): sol, the default, or souvenir. Any other coin takes sol only.",
"enum": [
"sol",
"souvenir"
],
"type": "string"
},
"side": {
"description": "buy: spend SOL for the coin. sell: the coin for SOL. With pay souvenir, $SOUVENIR in place of SOL.",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"slippageBps": {
"default": 300,
"description": "The most the price may move against you before the trade refuses, in basis points (300 is 3%, the site's default).",
"maximum": 5000,
"minimum": 10,
"type": "integer"
}
},
"required": [
"mint",
"side",
"amount"
],
"type": "object"
},
"name": "quote_trade",
"outputSchema": null
},
{
"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 fewer than limit.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"limit": {
"default": 20,
"description": "Wins a page.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"nsfw": {
"default": false,
"description": "true to list wins of adult (NSFW) prizes too; left out by default.",
"type": "boolean"
}
},
"type": "object"
},
"name": "recent_wins",
"outputSchema": null
},
{
"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 the url and say what the trade is (buy or sell, the coin, the amount). Nothing happens until they approve it in their wallet: Souvenir and you never sign for them. The link lasts an hour, makes at most one trade, and asks for at most 10% slippage (slippageBps 10 to 1000, 300 by default). Then read how it ended with trade_request. A coin paired with $SOUVENIR is paid in SOL (a sell receives SOL), through $SOUVENIR in one transaction.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"amount": {
"description": "What you give, in whole units, as a string: lamports for a buy (1 SOL is 1000000000), the coin's raw units for a sell (Souvenir's and pump.fun's coins have 6 decimals: 1 coin is 1000000).",
"pattern": "^[0-9]{1,20}$",
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"side": {
"description": "buy: spend SOL for the coin. sell: the coin for SOL.",
"enum": [
"buy",
"sell"
],
"type": "string"
},
"slippageBps": {
"description": "The most the price may move against the trade, in basis points (300 is 3%): 10 to 1000, 300 by default.",
"maximum": 1000,
"minimum": 10,
"type": "integer"
}
},
"required": [
"mint",
"side",
"amount"
],
"type": "object"
},
"name": "request_trade",
"outputSchema": null
},
{
"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 the token from sign_in, as token or as the request's Authorization: Bearer header.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "The key's id (create_coin_key's id).",
"maxLength": 100,
"type": "string"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "revoke_coin_key",
"outputSchema": null
},
{
"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), potSol (the open pot), prize (full mode: id, image, priceUsd), round (the latest unfinished one: number, state, targetSol, potSol), holders (at the latest snapshot), links and pair ({ symbol, mint, solPerSouv } on a coin that trades against $SOUVENIR, else null). For the next page, pass nextCursor back as cursor; it is null on the last page. Coins whose prize is adult (NSFW) are left out, as on the site, unless nsfw is true.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "The last page's nextCursor.",
"type": "string"
},
"limit": {
"default": 20,
"description": "Coins a page.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"nsfw": {
"default": false,
"description": "true to list coins whose prize is adult (NSFW) too; left out by default.",
"type": "boolean"
},
"q": {
"description": "Search: a coin's name or ticker ($ optional), its prize's name, or the start of its mint.",
"maxLength": 60,
"type": "string"
},
"sort": {
"default": "pot",
"description": "pot: the largest open pot first. new: the newest launch first. drawing: the closest to its next draw first (the pot nearest its target). holders: the most holders first.",
"enum": [
"pot",
"new",
"drawing",
"holders"
],
"type": "string"
},
"venue": {
"description": "Only coins trading there: pump.fun, Meteora or Bags.",
"enum": [
"pump",
"meteora",
"bags"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_coins",
"outputSchema": null
},
{
"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 here: a launch names one by its market name, such as \"AK-47 | Redline (Field-Tested)\". 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"kind": {
"description": "Only one kind: goods (store items), services, gift (gift cards), stars (Telegram Stars), packs, graded (graded cards), nft (Solana NFTs), evm (Ethereum NFTs), stock (shares and tokens), cs2case (CS2 cases) or trips.",
"enum": [
"goods",
"services",
"gift",
"stars",
"packs",
"graded",
"nft",
"evm",
"stock",
"cs2case",
"trips"
],
"type": "string"
},
"limit": {
"default": 20,
"description": "Prizes a page.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"description": "The last page's next.",
"minimum": 0,
"type": "integer"
},
"q": {
"description": "Words of the prize's name, brand or store.",
"maxLength": 60,
"type": "string"
}
},
"type": "object"
},
"name": "search_prizes",
"outputSchema": null
},
{
"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 the network in time it may still land: its signature is answered the same. Trading a coin, in order: (1) quote_trade to see what you would get; (2) build_trade with your wallet's address; (3) sign the transaction it answers with your wallet; (4) send_transaction, or send it yourself through any Solana RPC. No sign-in: your wallet's signature is the approval, and Souvenir never needs its private key. The same fees and limits as the coin's page on souvenir.finance. An agent helping a person, which can't sign with their wallet, uses request_trade instead and gives them the link to approve it with their own wallet.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"transaction": {
"description": "The transaction build_trade answered (or prepare_launch's devSwap or souvSwap), signed by your wallet, base64.",
"maxLength": 3000,
"type": "string"
}
},
"required": [
"transaction"
],
"type": "object"
},
"name": "send_transaction",
"outputSchema": null
},
{
"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) or prizes (you give prizes from its pot with award_prize; only a coin nobody but you holds can switch to it, has_holders otherwise). Answers the coin, as get_coin does. Takes a coin key from create_coin_key as coinKey or as the request's Authorization: Bearer ck_live_… header; it works for every coin its wallet created. Refused with \"The coin API's keys and writes are not open yet.\" while they are not open.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"coinKey": {
"description": "Your coin key (ck_live_…, from create_coin_key). Not needed when the request sends it as Authorization: Bearer ck_live_….",
"type": "string"
},
"drawSol": {
"description": "draws: the SOL each round pays, 0.1 to 100, as a decimal string (\"0.5\").",
"pattern": "^[0-9]{1,6}(\\.[0-9]{1,9})?$",
"type": "string"
},
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"mode": {
"enum": [
"full",
"draws",
"prizes"
],
"type": "string"
}
},
"required": [
"mint",
"mode"
],
"type": "object"
},
"name": "set_coin_mode",
"outputSchema": null
},
{
"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, the dearest at most curator.spread times it, and at least curator.minItems items must fit). Claude reads the brief here and picks among the real items that fit; a brief it will not take is refused. Give the id to prepare_launch as curator: { sample: id }, with no skin: round 1's prize is the sample's, and after each draw the coin picks the next one itself, by choice, not by chance. A sample is kept a day; at most 5 an hour a wallet. Only while launch_options says curator is not null. 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.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"brief": {
"description": "What the coin should like, in a line or two of plain words: no links, @handles or $tickers.",
"maxLength": 280,
"minLength": 1,
"type": "string"
},
"maxUsd": {
"description": "The band's dearest price, in dollars: at most 10 times the cheapest.",
"type": "number"
},
"minUsd": {
"description": "The band's cheapest price, in dollars.",
"minimum": 5,
"type": "number"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
}
},
"required": [
"brief",
"minUsd",
"maxUsd"
],
"type": "object"
},
"name": "shopper_sample",
"outputSchema": null
},
{
"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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "The id sign_in_challenge gave.",
"type": "string"
},
"signature": {
"description": "The wallet's ed25519 signature of the message, base64 (64 bytes).",
"type": "string"
}
},
"required": [
"id",
"signature"
],
"type": "object"
},
"name": "sign_in",
"outputSchema": null
},
{
"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) launch_options, and search_prizes for the prize (or shopper_sample for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"wallet": {
"description": "Your Solana wallet's address (base58): the wallet that will launch, pay and sign.",
"type": "string"
}
},
"required": [
"wallet"
],
"type": "object"
},
"name": "sign_in_challenge",
"outputSchema": null
},
{
"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.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The mint prepare_launch answered.",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
},
"transaction": {
"description": "The same, as one string instead of a list.",
"type": "string"
},
"transactions": {
"description": "The transaction prepare_launch answered, signed by your wallet, base64.",
"items": {
"type": "string"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "submit_launch",
"outputSchema": null
},
{
"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.\" while it is not open to your wallet. 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 for a coin that picks its own prizes); (3) prepare_launch; (4) sign the transaction it answers with your wallet, without sending it, and give it to submit_launch; (5) launch_status until it answers confirmed: a pump.fun launch first answers split with a second transaction, which you sign (or sign and send) and give to submit_split, then launch_status again. Your wallet pays and signs everything: Souvenir never needs or asks for its private key.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"mint": {
"description": "The coin's mint address (base58).",
"pattern": "^[1-9A-HJ-NP-Za-km-z]{32,44}$",
"type": "string"
},
"signature": {
"description": "The split's signature, sent by your wallet.",
"type": "string"
},
"token": {
"description": "The token sign_in gave. Not needed when the request sends it as Authorization: Bearer <token>.",
"type": "string"
},
"transaction": {
"description": "Or the split signed by your wallet, base64, for Souvenir to send.",
"type": "string"
}
},
"required": [
"mint"
],
"type": "object"
},
"name": "submit_split",
"outputSchema": null
},
{
"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 landed), declined (they declined it), expired (an hour passed with no approval) or stopped (the approval stopped partway, so Souvenir can't tell whether the trade went out: the person should check their wallet before asking for a new link). A link that ended never comes back: ask for a new one. wallet and out are given once the trade was sent; out is what the trade was built to give (coins for a buy, lamports for a sell); the exact amount is on chain under signature. Read it every few seconds while it is open or sent.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"id": {
"description": "The id request_trade answered.",
"pattern": "^[0-9a-f]{32}$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "trade_request",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:763a8041597f6871c938c949f07962a5e0aeb6370b1b20057a973ef963eb9336 | sha256sum