Developers · API v1

Build on AMDPAD

Read every AMDPAD coin and build its transactions over HTTP. Put them in a bot, a wallet, a dashboard or your own trading front end, without learning Meteora's SDKs. Each coin has 64,000,000 supply, trades against tokenized AMD stock on a Meteora bonding curve whose price doubles each era, and graduates to a Meteora DAMM v2 pool.

No API key. JSON over HTTPS, open to every origin (CORS).
Your users keep their keys. Trades and launches come back as unsigned transactions; the user's wallet signs and sends them.
Curve or pool, handled. Buys and sells route to the bonding curve or, after graduation, the DAMM v2 pool. Buys can pay in SOL.
Live events. One stream for new coins, new eras, graduations and burns.

Base URL	`https://amdpad.xyz/api/v1`
Network	Solana: real tokenized AMD is at stake
OpenAPI	`/api/v1/openapi.json`
Status	The v1 contract is stable; the service has no uptime guarantee.

Start in three calls

Find a coin, quote it, sign the buy.

1. Find a coin

curl "https://amdpad.xyz/api/v1/coins?sort=progress&graduated=false&limit=5"

2. Quote it

curl "https://amdpad.xyz/api/v1/quote?mint=<mint>&side=buy&amount=0.05"

3. Build the transaction, sign it in the wallet, send it

TypeScript · @solana/web3.js + wallet adapter

import { Transaction, VersionedTransaction } from "@solana/web3.js";

const res = await fetch("https://amdpad.xyz/api/v1/tx/buy", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ wallet: wallet.publicKey.toBase58(), mint, amd: 0.05, slippageBps: 200 }),
}).then((r) => r.json());
if (res.error) throw new Error(res.error);

const bytes = Uint8Array.from(atob(res.transaction), (c) => c.charCodeAt(0));
const tx = res.version === 0 ? VersionedTransaction.deserialize(bytes) : Transaction.from(bytes);
const signature = await wallet.sendTransaction(tx, connection);

Learn the concepts

Units

Quantity	Unit in the API	On chain
AMD amounts	AMD, a decimal number	6 decimals (1 AMD = 10^6 µAMD; a Token-2022 mint)
Coin amounts	Whole coins, a decimal number	6 decimals, 64,000,000 supply per coin
Prices	µAMD per coin (priceAtoms). 1 µAMD = 10^-6 AMD, the "Atoms" in field names	Read from the pool's sqrt price
Fully diluted value	AMD (fdvAmd)	priceAtoms × 64,000,000 ÷ 10^6
Market cap	AMD (mcapAmd)	priceAtoms × coins in circulation ÷ 10^6 (coinsSold until graduation)
Times	Unix seconds (event timestamps `at`: Unix ms)	—

Numbers are JSON floats, fine for display and quotes. The transactions themselves use exact integer amounts, and out.min is what the chain enforces.

A coin's life

Launch. Every coin uses one curve (tier standard), which graduates at 11.5 AMD raised. Supply, curve, eras and fees are the same for every coin. The creator picks a mode: creator (the creator share of fees goes to the creator), holders (it goes to the coin's holders: 60% of every fee, credited pro rata at snapshots and claimed through /holders/claim) or burn (it buys the coin back and burns it, in hourly slices).
Anti-snipe. On the current configs the fee starts high and drops each second after launch (49.99% / 33.66% / 17.33% / 1%); feeBpsNow on a coin and feeBps on a quote show the live value. The bundled firstBuyAmd in tx/launch pays 1%.
Bonding curve, four eras. 8-bit, 16-bit, 32-bit, 64-bit. In each era the price doubles and the coins sold halve, so each era raises the same AMD. Entering the next era: era.index goes up and you get a coin.era event. Each trade pays a 1% fee in AMD.
Graduation. When amdRaised reaches graduationAmd, the coin moves to a Meteora DAMM v2 pool (migrated: true, dammPool set, a coin.graduated event). Trading continues there; the API routes to it automatically and quotes show venue: "dammV2".

Which network

This deployment serves Solana. Every response carries an X-Cluster header (mainnet-beta), and GET /api/v1 returns cluster. Check it before asking a user to sign, and send the transaction to an RPC on the same network.

Sign transactions

transaction is base64. Decode it, then Transaction.from(bytes) when version is "legacy", or VersionedTransaction.deserialize(bytes) when it is 0 (buys paid in SOL).
The fee payer is wallet. Nothing is signed on our side. Launches also need the new mint keypair's signature (see the launch recipe).
The transaction has a recent blockhash: sign and send within about 60 seconds, or build a new one.
Slippage protection is on chain: if the price moves past slippageBps, the transaction fails and nothing is spent but the network fee.
Simulate before sending if you want an early error (insufficient AMD, for example); wallets usually do this for you.

Handle errors and limits

Errors are JSON: { "error": "slippageBps: an integer from 0 to 5000" }. The message says what to fix.

Status	Meaning
`400`	Bad input: a parameter is missing or invalid.
`404`	Not a AMDPAD coin on this network.
`409`	Launch: that mint already exists.
`413 / 415`	Metadata: the image is too big, or not PNG, JPG or GIF.
`429`	Rate limited. `retryAfterSecs` says when to retry.
`502`	A chain read or route failed upstream. Safe to retry.
`503`	Not deployed on this network yet, or the event stream is full.

Limits per IP address:

Bucket	Limit	Endpoints
`read`	120 per 1 min	/, /coins, /coins/{mint}, /curves, /burns, /amd-usd, /coins/{mint}/holders, /coins/{mint}/holders/{wallet}, /holders/claim/status
`quote`	60 per 1 min	/quote
`tx`	30 per 1 min	/tx/buy, /tx/sell
`claimPrepare`	10 per 1 min	/holders/claim/prepare
`claimSubmit`	5 per 1 min	/holders/claim/submit
`launch`	5 per 10 min	/tx/launch
`metadata`	10 per 10 min	/metadata
`stream`	10 per 1 min	/events

Need more? Cache the read endpoints (their Cache-Control headers say for how long) and use the event stream instead of polling.

API reference

Market

Get the API index

GET/api/v1

The network this deployment serves, the curve tier with its DBC config per launch mode, the anti-snipe schedule, the holders-mode constants, the AMD quote mint, token rules, fees, program IDs, the keeper and treasury, and the endpoint list. Read it once at startup and check cluster.

Limit 120 reads per 1 min per IP · cached 1 min

Request

curl https://amdpad.xyz/api/v1

Response 200

{
  "name": "AMDPAD API",
  "version": "1.0",
  "cluster": "mainnet-beta",
  "deployed": true,
  "token": {
    "supply": 64000000,
    "decimals": 6,
    "mintAuthority": null,
    "freezeAuthority": null
  },
  "quote": {
    "mint": "<amd mint>",
    "decimals": 6
  },
  "tiers": [
    {
      "id": "standard",
      "name": "Standard",
      "graduationAmd": 11.5,
      "configs": {
        "creator": "<config>",
        "holders": "<config>",
        "burn": "<config>"
      }
    }
  ],
  "modes": [
    {
      "id": "creator",
      "name": "Creator"
    },
    {
      "id": "holders",
      "name": "Holders"
    },
    {
      "id": "burn",
      "name": "Burn"
    }
  ],
  "antiSnipe": {
    "startFeeBps": 4999,
    "endFeeBps": 100,
    "periods": 3,
    "seconds": 3,
    "mode": "linear"
  },
  "eras": [
    {
      "index": 0,
      "name": "8-bit"
    },
    {
      "index": 1,
      "name": "16-bit"
    },
    {
      "index": 2,
      "name": "32-bit"
    },
    {
      "index": 3,
      "name": "64-bit"
    }
  ],
  "fees": {
    "tradingFeeBps": 100,
    "protocolShareBps": 2000,
    "creatorShareBps": 7500,
    "buybackShareOfFees": 0.15,
    "treasuryShareOfFees": 0.05,
    "modes": {
      "creator": "…",
      "holders": "…",
      "burn": "…"
    }
  },
  "holders": {
    "distributor": "<address>",
    "shareOfPartnerBps": 7500,
    "shareOfLpBps": 8000,
    "minUsd": 10,
    "minAtomsNow": 19305,
    "minClaimAtoms": 1000,
    "…": "…"
  },
  "programs": {
    "dbc": "<program>",
    "dammV2": "<program>"
  },
  "keeper": "<address>",
  "treasury": "<address>",
  "nativeCoin": {
    "symbol": "AMDPAD",
    "mint": "<mint>"
  },
  "endpoints": {
    "GET /api/v1/coins": "…"
  }
}

List coins

GET/api/v1/coins

Every coin with its live state and metadata. The list is refreshed every few seconds; page through it with limit and offset.

Limit 120 reads per 1 min per IP · cached 3 s

Query

sortstring: Newest first, largest market cap first (price × coins in circulation), largest fully diluted value first, closest to graduation first, or boosted coins first (by boostScore: native coins burned to boost the coin, each boost fading to zero over 24 hours).One of new, mcap, fdv, progress, boost.Default new.
graduatedboolean: true: only coins trading on DAMM v2. false: only coins still on the bonding curve.
tierstring: Only coins on this curve tier (there is one).One of standard.
modestring: Only coins in this launch mode.One of creator, holders, burn.
limitinteger: Page size, 1 to 200.Default 50.
offsetinteger: Coins to skip.Default 0.

Request

curl "https://amdpad.xyz/api/v1/coins?sort=progress&graduated=false&limit=10"

Response 200

{
  "total": 42,
  "offset": 0,
  "limit": 10,
  "coins": [
    {
      "mint": "<mint>",
      "pool": "<dbc pool>",
      "config": "<config>",
      "tier": "standard",
      "mode": "creator",
      "feeBpsNow": 100,
      "antiSnipeUntil": 1791103359,
      "creator": "<wallet>",
      "activatedAt": 1791103356,
      "priceAtoms": 0.1187,
      "fdvAmd": 7.5968,
      "mcapAmd": 2.647,
      "amdRaised": 2.0475,
      "graduationAmd": 11.5,
      "progress": 0.178,
      "era": {
        "index": 0,
        "name": "8-bit",
        "progress": 0.7114,
        "coinsToHalving": 6410000.12
      },
      "coinsSold": 22301000.5,
      "migrated": false,
      "dammPool": null,
      "partnerFeeAmdUnclaimed": 0.000011,
      "tradingFeeAmdTotal": 0.002011,
      "creatorFeeAmdUnclaimed": 0.000033,
      "creatorSurplusPending": false,
      "meta": {
        "name": "Silicon Cat",
        "symbol": "SCAT",
        "uri": "https://…/metadata.json",
        "image": "https://…/image.png",
        "description": "…",
        "socials": {
          "twitter": "https://x.com/…"
        }
      },
      "isNative": false
    },
    "…"
  ]
}

400 A parameter is missing or invalid; error names it.

Get a coin

GET/api/v1/coins/{mint}

One coin's live state and metadata, the same object as in the list.

Limit 120 reads per 1 min per IP · cached 2 s

Path

mintstringrequired: The coin's mint address.

Request

curl https://amdpad.xyz/api/v1/coins/<mint>

Response 200

{
  "mint": "<mint>",
  "pool": "<dbc pool>",
  "config": "<config>",
  "tier": "standard",
  "mode": "creator",
  "feeBpsNow": 100,
  "antiSnipeUntil": 1791103359,
  "creator": "<wallet>",
  "activatedAt": 1791103356,
  "priceAtoms": 0.1187,
  "fdvAmd": 7.5968,
  "mcapAmd": 2.647,
  "amdRaised": 2.0475,
  "graduationAmd": 11.5,
  "progress": 0.178,
  "era": {
    "index": 0,
    "name": "8-bit",
    "progress": 0.7114,
    "coinsToHalving": 6410000.12
  },
  "coinsSold": 22301000.5,
  "migrated": false,
  "dammPool": null,
  "partnerFeeAmdUnclaimed": 0.000011,
  "tradingFeeAmdTotal": 0.002011,
  "creatorFeeAmdUnclaimed": 0.000033,
  "creatorSurplusPending": false,
  "meta": {
    "name": "Silicon Cat",
    "symbol": "SCAT",
    "uri": "https://…/metadata.json",
    "image": "https://…/image.png",
    "description": "…",
    "socials": {
      "twitter": "https://x.com/…"
    }
  },
  "isNative": false
}

400 A parameter is missing or invalid; error names it.
404 The mint is not a coin on this network.

Get the curve

GET/api/v1/curves

The curve, keyed by tier (every launch mode shares it): the four eras with their AMD and price ranges and coins sold, sampled points for charting, and the coins that go into the DAMM v2 pool at graduation. Curves are immutable on chain, so cache this as long as you like.

Limit 120 reads per 1 min per IP · cached 60 min

Request

curl https://amdpad.xyz/api/v1/curves

Response 200

{
  "standard": {
    "tier": "standard",
    "graduationAmd": 11.5,
    "eras": [
      {
        "index": 0,
        "name": "8-bit",
        "fromAmd": 0,
        "toAmd": 2.8779,
        "fromAtoms": 0.0708,
        "toAtoms": 0.1416,
        "coins": 28711000
      },
      {
        "index": 1,
        "name": "16-bit",
        "fromAmd": 2.8779,
        "toAmd": 5.7558,
        "fromAtoms": 0.1416,
        "toAtoms": 0.2831,
        "coins": 14355500
      },
      "…"
    ],
    "points": [
      {
        "coins": 0,
        "atoms": 0.0708,
        "amd": 0,
        "era": 0
      },
      {
        "coins": 1004000,
        "atoms": 0.0723,
        "amd": 0.0719,
        "era": 0
      },
      "…"
    ],
    "lpCoins": 10165000
  }
}

Get buyback & burn

GET/api/v1/burns

The native coin's circulating and burned supply (64,000,000 minus the mint's supply), the treasury's AMD balance, and the keeper's buyback & burn transactions over its whole history, newest first, 10 per page (pages in all). txCount counts every burn transaction (historyComplete is false while older history is still being read). why is buyback or leftover (a graduated coin's unsold curve remainder). Pass next as before for the next page, which returns { burns, next }.

Limit 120 reads per 1 min per IP · cached 15 s

Query

beforestring: The next cursor from the previous page: returns the burns after that transaction as { burns, next }.

Request

curl https://amdpad.xyz/api/v1/burns

Response 200

{
  "nativeMint": "<mint>",
  "nativeSymbol": "AMDPAD",
  "keeper": "<address>",
  "burnedCoins": 21955.54,
  "supplyCoins": 63978044.46,
  "treasury": {
    "address": "<address>",
    "amd": 0.5112
  },
  "txCount": 42,
  "historyComplete": true,
  "pages": 5,
  "burns": [
    {
      "signature": "<signature>",
      "time": 1791140807,
      "mint": "<mint>",
      "coins": 10.2039,
      "why": "buyback"
    },
    "…"
  ],
  "next": "<signature>"
}

400 A parameter is missing or invalid; error names it.

Get AMD/USD

GET/api/v1/amd-usd

The AMD/USD rate the site uses for dollar figures; null when every price source is down. Multiply an AMD amount by it, or priceAtoms / 1000000 × usd for a coin's dollar price.

Limit 120 reads per 1 min per IP · cached 30 s

Request

curl https://amdpad.xyz/api/v1/amd-usd

Response 200

{
  "usd": 518
}

Trading

Quote a trade

GET/api/v1/quote

What a buy or sell would return right now, without building a transaction. On the bonding curve it also previews the era after the trade: whether it crosses into the next era, or completes the curve and graduates. That preview uses the AMD raised after the 1% fee; treat it as an estimate.

Limit 60 quotes per 1 min per IP · cached 2 s

Query

mintstringrequired: The coin.
sidestring: Buy coins, or sell coins for AMD.One of buy, sell.Default buy.
amountnumberrequired: Buys: AMD to spend (or SOL with in=sol). Sells: coins to sell.
instring: Buys only: pay in AMD, or in SOL swapped to AMD in the same transaction.One of amd, sol.Default amd.
slippageBpsinteger: Sets out.min, 0 to 5000.Default 200.

Request

curl "https://amdpad.xyz/api/v1/quote?mint=<mint>&side=buy&amount=0.5"

Response 200

{
  "mint": "<mint>",
  "side": "buy",
  "in": {
    "asset": "amd",
    "amount": 0.5
  },
  "out": {
    "asset": "coin",
    "expected": 3960000.5,
    "min": 3880800.49
  },
  "viaAmd": null,
  "slippageBps": 200,
  "spotPriceAtoms": 0.1187,
  "avgPriceAtoms": 0.1263,
  "priceImpact": 0.064,
  "venue": "curve",
  "era": {
    "before": 0,
    "after": 0,
    "crossesHalving": false,
    "graduates": false
  }
}

400 A parameter is missing or invalid; error names it.
404 The mint is not a coin on this network.

Build a buy

POST/api/v1/tx/buy

An unsigned transaction that buys the coin for wallet. Send exactly one of amd or sol. With sol, one v0 transaction swaps SOL to AMD and buys with the AMD that swap guarantees; any extra AMD stays in the wallet. Graduated coins are bought on their DAMM v2 pool.

Limit 30 buy / sell transactions per 1 min per IP · not cached

JSON body

walletstringrequired: The buyer; signs and pays fees.
mintstringrequired: The coin.
amdnumber: AMD to spend.
solnumber: SOL to spend instead of AMD.
slippageBpsinteger: Maximum slippage in basis points, 0 to 5000. 200 = 2%.Default 200.

Request

curl -X POST https://amdpad.xyz/api/v1/tx/buy -H "Content-Type: application/json" \
  -d '{"wallet":"<wallet>","mint":"<mint>","amd":0.05,"slippageBps":200}'

Response 200

{
  "transaction": "<base64>",
  "version": "legacy",
  "mint": "<mint>",
  "wallet": "<wallet>",
  "in": {
    "asset": "amd",
    "amount": 0.05
  },
  "expectedCoins": 415000.4,
  "minCoins": 406700.39,
  "note": "Sign with the wallet and send within ~60 s (the blockhash expires)."
}

400 A parameter is missing or invalid; error names it.
404 The mint is not a coin on this network.
502 The chain read or the SOL route failed (for SOL buys: try a different amount, or pay in AMD).

Build a sell

POST/api/v1/tx/sell

An unsigned transaction that sells coins from wallet for AMD, on the bonding curve or the DAMM v2 pool.

Limit 30 buy / sell transactions per 1 min per IP · not cached

JSON body

walletstringrequired: The seller; signs and pays fees.
mintstringrequired: The coin.
coinsnumberrequired: Coins to sell.
slippageBpsinteger: Maximum slippage in basis points, 0 to 5000. 200 = 2%.Default 200.

Request

curl -X POST https://amdpad.xyz/api/v1/tx/sell -H "Content-Type: application/json" \
  -d '{"wallet":"<wallet>","mint":"<mint>","coins":1000}'

Response 200

{
  "transaction": "<base64>",
  "version": "legacy",
  "mint": "<mint>",
  "wallet": "<wallet>",
  "in": {
    "asset": "coin",
    "amount": 1000
  },
  "expectedAmd": 0.000117,
  "minAmd": 0.000115,
  "note": "Sign with the wallet and send within ~60 s (the blockhash expires)."
}

400 A parameter is missing or invalid; error names it.
404 The mint is not a coin on this network.

Launch

Upload metadata

POST/api/v1/metadata

Stores the coin's image and a Metaplex-style metadata JSON on permanent storage and returns its uri for the launch. Send the image as a file, or link one with imageUrl.

Limit 10 metadata uploads per 10 min per IP · not cached

Form fields (multipart/form-data)

namestringrequired: Up to 32 characters.
symbolstringrequired: 2 to 10 letters or digits; uppercased.
imagefile: PNG, JPG or GIF, at most 1 MB.
imageUrlstring: An http(s) image URL instead of a file.
descriptionstring: Up to 500 characters.
twitterstring: http(s) URL.
telegramstring: http(s) URL.
websitestring: http(s) URL.

Request

curl -X POST https://amdpad.xyz/api/v1/metadata \
  -F name="Silicon Cat" -F symbol=SCAT -F image=@cat.png -F twitter=https://x.com/siliconcat

Response 200

{
  "uri": "https://…/metadata.json",
  "image": "https://…/image.png",
  "provider": "…"
}

400 A parameter is missing or invalid; error names it.
413 The image is over 1 MB.
415 The image is not a PNG, JPG or GIF.
502 The storage provider failed.

Build a launch

POST/api/v1/tx/launch

A transaction that creates the coin on the curve in the chosen launch mode, with an optional first buy in the same transaction so nobody can buy ahead of the creator. The first buy pays the 1% fee; separate buys in the first 3 seconds pay the anti-snipe fee (49.99% / 33.66% / 17.33% / 1%). Generate a fresh keypair for the mint and send only its public key: the transaction needs the wallet's and the mint keypair's signatures. Supply, decimals and the revoked mint and freeze authorities come from the config and can't be changed.

Limit 5 launch transactions per 10 min per IP · not cached

JSON body

walletstringrequired: The creator; signs and pays fees. In creator mode it receives the creator share of trading fees.
mintstringrequired: Public key of a fresh keypair you generated.
tierstring: Optional: there is one curve, with a graduation target of 11.5 AMD.One of standard.Default standard.
modestring: Who gets the creator share (60% of every fee): the creator, the coin's holders (credited pro rata, claimed with /holders/claim), or burn (it buys the coin back and burns it, in hourly slices). Permanent.One of creator, holders, burn.Default creator.
namestringrequired: Up to 32 characters.
symbolstringrequired: 2 to 10 letters or digits.
uristringrequired: The metadata JSON URL, from POST /api/v1/metadata.
firstBuyAmdnumber: AMD the creator buys with in the launch transaction.Default 0.

Request

curl -X POST https://amdpad.xyz/api/v1/tx/launch -H "Content-Type: application/json" \
  -d '{"wallet":"<wallet>","mint":"<new mint>","mode":"creator","name":"Silicon Cat",
       "symbol":"SCAT","uri":"https://…/metadata.json","firstBuyAmd":0.05}'

Response 200

{
  "transaction": "<base64>",
  "version": "legacy",
  "mint": "<mint>",
  "wallet": "<wallet>",
  "tier": "standard",
  "mode": "creator",
  "config": "<config>",
  "pool": "<dbc pool>",
  "firstBuyAmd": 0.05,
  "signers": [
    "<wallet>",
    "<mint>"
  ],
  "note": "Sign with the wallet and the mint keypair, then send within ~60 s (the blockhash expires)."
}

400 A parameter is missing or invalid; error names it.
409 That mint already has a pool: generate a fresh keypair.

Holders

Get a coin's holder totals

GET/api/v1/coins/{mint}/holders

Holders-mode coins: 60% of every trading fee is the holders' fee share, credited in AMD to wallets holding at least $10 of the coin (valued at each snapshot: coins × the coin's price × AMD/USD), pro rata, at frequent random snapshots. It depends only on trading volume and can be zero. This returns what was credited and paid so far, in µAMD (…Atoms fields: 1 µAMD = 1 atom = 10^-6 AMD), and the threshold: minUsd, and minAtoms / minCoins at the current prices.

Limit 120 reads per 1 min per IP · cached 5 s

Path

mintstringrequired: The coin.

Request

curl https://amdpad.xyz/api/v1/coins/<mint>/holders

Response 200

{
  "mint": "<mint>",
  "tracked": true,
  "creditedAtoms": 13398,
  "paidAtoms": 4100,
  "pendingAtoms": 0,
  "wallets": 4,
  "lastSnapshotAt": "2026-10-05T16:20:46.937Z",
  "feeCursorAtoms": 17864,
  "claimsPaused": false,
  "minUsd": 10,
  "minAtoms": 19305,
  "minCoins": 162637
}

404 Not a holders-mode coin (or not snapshotted yet).
503 This server has no holder ledger.

Get a wallet's share

GET/api/v1/coins/{mint}/holders/{wallet}

One wallet's share on a holders-mode coin: credited so far (fractions of a µAMD accumulate), claimed, reserved by a claim in flight, and claimable now in whole µAMD.

Limit 120 reads per 1 min per IP · cached 2 s

Path

mintstringrequired: The coin.
walletstringrequired: The holder.

Request

curl https://amdpad.xyz/api/v1/coins/<mint>/holders/<wallet>

Response 200

{
  "mint": "<mint>",
  "wallet": "<wallet>",
  "accruedAtoms": 4817.222034,
  "claimedAtoms": 0,
  "pendingAtoms": 0,
  "claimableAtoms": 4817,
  "minClaimAtoms": 1000,
  "pendingClaim": null,
  "lastClaim": null,
  "claimsPaused": false
}

400 A parameter is missing or invalid; error names it.
503 This server has no holder ledger.

Prepare a claim

POST/api/v1/holders/claim/prepare

The wallet's whole claimable share (from 1000 µAMD) as a legacy transaction with the holder as fee payer, plus a token bound to its exact bytes. Sign it with the wallet (sign only, don't send): the holder pays the network fee and, once, the rent of their AMD token account. Nothing is reserved yet. Limit: 10 per minute per wallet and per IP.

Limit 10 claim prepares per 1 min per IP · not cached

JSON body

mintstringrequired: The coin.
walletstringrequired: The holder (signs as fee payer).

Request

curl -X POST https://amdpad.xyz/api/v1/holders/claim/prepare -H "Content-Type: application/json" -d '{"mint":"<mint>","wallet":"<wallet>"}'

Response 200

{
  "transaction": "<base64>",
  "token": "<token>",
  "atoms": 4817,
  "lastValidBlockHeight": 491234567
}

400 A parameter is missing or invalid; error names it.
409 A claim is already in flight.
429 Rate limited.
503 Claims are paused or not set up.

Submit a signed claim

POST/api/v1/holders/claim/submit

The holder-signed transaction from prepare. The claim service checks the bytes are exactly the prepared ones and the holder's signature, reserves the amount, then co-signs and sends. Any change to the transaction (for example an instruction a wallet adds) is refused: prepare again. Poll the status until it settles. Limit: 5 per minute per wallet and per IP.

Limit 5 claim submits per 1 min per IP · not cached

JSON body

tokenstringrequired: From prepare.
signedTxstringrequired: The transaction signed by the holder, base64.

Request

curl -X POST https://amdpad.xyz/api/v1/holders/claim/submit -H "Content-Type: application/json" -d '{"token":"<token>","signedTx":"<base64>"}'

Response 200

{
  "signature": "<signature>",
  "status": "pending",
  "wallet": "<wallet>"
}

400 A parameter is missing or invalid; error names it.
409 Over the claimable share, or a claim already in flight.
410 The blockhash is about to expire: prepare again.
503 Funds settling (try again in about a minute) or claims paused.

Get a claim's status

GET/api/v1/holders/claim/status

pending until the chain confirms the transfer (confirmed), it lands with an error (failed: nothing deducted), or its blockhash dies without it landing (expired: nothing deducted).

Limit 120 reads per 1 min per IP · not cached

Query

signaturestringrequired: The claim's signature from submit.

Request

curl 'https://amdpad.xyz/api/v1/holders/claim/status?signature=<signature>'

Response 200

{
  "signature": "<signature>",
  "status": "confirmed",
  "atoms": 4817,
  "mint": "<mint>",
  "wallet": "<wallet>",
  "error": null
}

404 No claim with that signature.

Events

Stream events

GET/api/v1/events

Server-sent events (text/event-stream) for new coins, new eras, graduations and burns, a few seconds after they land on chain. Each event has an id; reconnect with the Last-Event-ID header (browsers' EventSource does this for you) or ?since=<id> to receive what you missed. The server keeps the last 200 events since it started.

Limit 10 event stream connections per 1 min per IP · not cached

Query

sinceinteger: Replay buffered events after this id.

Request

curl -N https://amdpad.xyz/api/v1/events

Stream

event: ready
data: {"cluster":"mainnet-beta"}

id: 7
event: coin.era
data: {"mint":"<mint>","symbol":"SCAT","name":"Silicon Cat","tier":"standard","fromEra":0,"toEra":1,"eraName":"16-bit","priceAtoms":0.1416,"at":1791147084827}

: ping

503 Too many open streams on the server; retry after the Retry-After seconds.

Objects

Coin

Returned by /coins and /coins/{mint}.

mintstring: The coin's mint address.
poolstring: Its Meteora DBC pool.
configstring: The DBC config it launched on (one per launch mode).
tierstring: The curve tier: standard.
modestring: creator (the creator gets the creator share of fees), holders (holders do) or burn (it buys the coin back and burns it).
feeBpsNowinteger: The live base fee in bps: anti-snipe in a coin's first 3 s (49.99% / 33.66% / 17.33% / 1%), then 100.
antiSnipeUntilinteger | null: Unix seconds the anti-snipe schedule ends.
creatorstring: The wallet that launched it.
activatedAtinteger: Unix seconds trading opened.
priceAtomsnumber: Current price in µAMD per coin (1 µAMD = 1 atom = 10^-6 AMD), from the curve or, once graduated, the DAMM v2 pool.
fdvAmdnumber: Fully diluted value in AMD: priceAtoms × 64,000,000 ÷ 10^6.
mcapAmdnumber: Market cap in AMD: priceAtoms × coins in circulation ÷ 10^6 (on the curve: coinsSold; graduated: the whole supply, so it equals fdvAmd).
amdRaisednumber: AMD on the bonding curve.
graduationAmdnumber: AMD raised at which the coin graduates (the curve's target).
progressnumber: amdRaised ÷ graduationAmd, 0 to 1.
era.indexinteger: 0 8-bit, 1 16-bit, 2 32-bit, 3 64-bit
era.namestring: The era's name.
era.progressnumber: 0 to 1 through the current era, by AMD raised.
era.coinsToHalvingnumber: Coins left to buy before the next era.
coinsSoldnumber: Coins bought off the curve so far.
migratedboolean: Graduated: now trades on Meteora DAMM v2.
dammPoolstring | null: The DAMM v2 pool once graduated.
partnerFeeAmdUnclaimednumber: Partner-side fees on the curve not yet claimed (creator mode: the platform's; holders mode: holders' and platform's).
tradingFeeAmdTotalnumber: Creator-share and platform fees on the curve, all time (Meteora's cut excluded).
creatorFeeAmdUnclaimednumber: The creator's unclaimed fees (always 0 in holders mode).
metaobject: name, symbol, uri, image, description and socials (twitter, telegram, website).
isNativeboolean: This is the platform's native coin, the one fees buy back and burn.

Quote

inobject: What goes in: asset (amd, sol or coin) and amount.
out.expectednumber: Coins (buys) or AMD (sells) out at the current state.
out.minnumber: The least the trade can return with your slippage; the transaction fails below it.
viaAmdnumber | null: SOL buys: the AMD the SOL swap guarantees, which then buys the coin.
spotPriceAtomsnumber: Price before the trade, µAMD per coin.
avgPriceAtomsnumber: AMD paid or received ÷ coins, in µAMD per coin, fee included.
priceImpactnumber: avgPriceAtoms ÷ spotPriceAtoms − 1: positive on buys, negative on sells.
venuestring: curve (Meteora DBC) or dammV2 (graduated).
feeBpsinteger: The base fee the quote used: up to 4999 in a new coin's first seconds (anti-snipe), else 100.
eraobject | null: Curve only: before, after (null = graduates), crossesHalving, graduates.

Transaction response

transactionstring: The serialized transaction, base64.
version"legacy" | 0: Deserialize with Transaction.from (legacy) or VersionedTransaction.deserialize (0).
expectedCoins / expectedAmdnumber: What the trade should return.
minCoins / minAmdnumber: The least it can return; below that it fails and nothing is spent.
notestring: Signing reminder.

Event types

From GET /api/v1/events. Every payload has at, the Unix ms the server saw it. The stream also sends a ready event on connect and a comment ping every 15 seconds.

coin.created

A coin launched.

{
  "mint": "<mint>",
  "symbol": "SCAT",
  "name": "Silicon Cat",
  "tier": "standard",
  "creator": "<wallet>",
  "pool": "<dbc pool>",
  "activatedAt": 1791147066,
  "at": 1791147073843
}

coin.era

A coin on the bonding curve entered its next era: the price has doubled since the era began and each AMD now buys half as many coins.

{
  "mint": "<mint>",
  "symbol": "SCAT",
  "name": "Silicon Cat",
  "tier": "standard",
  "fromEra": 0,
  "toEra": 1,
  "eraName": "16-bit",
  "priceAtoms": 0.1416,
  "at": 1791147084827
}

coin.graduated

A coin raised its target and moved to its Meteora DAMM v2 pool.

{
  "mint": "<mint>",
  "symbol": "SCAT",
  "name": "Silicon Cat",
  "tier": "standard",
  "dammPool": "<damm v2 pool>",
  "priceAtoms": 1.1325,
  "at": 1791150000000
}

burn

A keeper buyback & burn (or a graduated coin's leftover burn) landed.

{
  "signature": "<signature>",
  "time": 1791140807,
  "mint": "<mint>",
  "coins": 10.2039,
  "why": "buyback",
  "at": 1791140812000
}

Recipes

Launch a coin from your app

TypeScript · browser

import { Keypair, Transaction } from "@solana/web3.js";

// 1. Image + metadata -> uri
const form = new FormData();
form.set("name", "Silicon Cat");
form.set("symbol", "SCAT");
form.set("image", file); // a File from an <input type="file">
const meta = await fetch("https://amdpad.xyz/api/v1/metadata", { method: "POST", body: form }).then((r) => r.json());
if (meta.error) throw new Error(meta.error);

// 2. A fresh keypair becomes the coin's mint
const mint = Keypair.generate();
const res = await fetch("https://amdpad.xyz/api/v1/tx/launch", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    wallet: wallet.publicKey.toBase58(),
    mint: mint.publicKey.toBase58(),
    name: "Silicon Cat",
    symbol: "SCAT",
    uri: meta.uri,
    firstBuyAmd: 0.05,
  }),
}).then((r) => r.json());
if (res.error) throw new Error(res.error);

// 3. Wallet + mint sign; the coin page is live once it confirms
const tx = Transaction.from(Uint8Array.from(atob(res.transaction), (c) => c.charCodeAt(0)));
const signature = await wallet.sendTransaction(tx, connection, { signers: [mint] });
console.log("https://amdpad.xyz/c/" + res.mint);

A new-era alert bot

Node 22 or later, no dependencies: read the stream with fetch and post wherever you like.

JavaScript · Node

const res = await fetch("https://amdpad.xyz/api/v1/events");
const reader = res.body.pipeThrough(new TextDecoderStream()).getReader();
let buf = "";
for (;;) {
  const { value, done } = await reader.read();
  if (done) break; // reconnect here with ?since=<last id>
  buf += value;
  let end;
  while ((end = buf.indexOf("\n\n")) >= 0) {
    const block = buf.slice(0, end);
    buf = buf.slice(end + 2);
    const type = /^event: (.*)$/m.exec(block)?.[1];
    const data = /^data: (.*)$/m.exec(block)?.[1];
    if (type === "coin.era") {
      const e = JSON.parse(data);
      console.log(`$${e.symbol} entered ${e.eraName} at ${e.priceAtoms.toFixed(3)} µAMD https://amdpad.xyz/c/${e.mint}`);
    }
  }
}

In a browser it is shorter:

JavaScript · browser

const es = new EventSource("https://amdpad.xyz/api/v1/events");
es.addEventListener("coin.graduated", (e) => console.log("graduated", JSON.parse(e.data).symbol));

Coins about to graduate

Python · requests

import requests

r = requests.get("https://amdpad.xyz/api/v1/coins", params={"sort": "progress", "graduated": "false", "limit": 10})
for c in r.json()["coins"]:
    print(f'{c["meta"]["symbol"]:>8}  {c["progress"]:6.1%}  {c["era"]["name"]:<10}  {c["priceAtoms"]:.3f} µAMD')

Price in dollars

TypeScript

const [{ usd }, coin] = await Promise.all([
  fetch("https://amdpad.xyz/api/v1/amd-usd").then((r) => r.json()),
  fetch("https://amdpad.xyz/api/v1/coins/<mint>").then((r) => r.json()),
]);
const priceUsd = (coin.priceAtoms / 10 ** 6) * usd;

Read straight from the chain

There is no AMDPAD program. A coin belongs to AMDPAD exactly when its Meteora DBC pool uses one of these configs, so you can index or trade without this API using @meteora-ag/dynamic-bonding-curve-sdk and @meteora-ag/cp-amm-sdk.

What	Address
creator mode config (11.5 AMD)	`3wUKchdzuAzLa9Tes33sksYaVase7TdpgJ91RfEJQopL`
holders mode config (11.5 AMD)	`5o9a66754a3WExqqtNx3Swdkokfvon149sgBCXCrwynN`
burn mode config (11.5 AMD)	`BBLm5U81KACC2szZyk7Po62ULskuHdpDcwLR8w6PYy9o`
Distributor: holders and burn configs (holdings worth $10+ share in holders coins)	`GH5K7VrACBkrrbzi6CkRAA1wVi1gqU9stRP6cohRad8q`
AMD quote mint (Token-2022; coins stay classic SPL)	`AMD8XwJXgQ9WV45Wyj9yFLejxzf2J6VM1PJY8bJEjeES`
DBC program	`dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN`
DAMM v2 program	`cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG`

A coin's pool is deriveDbcPoolAddress(quoteMint, mint, config). Era boundaries follow from the config's curve: four constant-product segments, one per era, each raising about a quarter of the graduation target.

Versioning

Within /api/v1, responses only gain fields. Ignore fields you don't know. Removing or renaming anything means /api/v2.
The unversioned /api/* routes serve this site and can change without notice. Build on /api/v1.
Buyback & burn describes what the platform does with its share of the fees.