Data API
Coins, trades, candles, holders, burns, rewards, payouts, creators and platform totals.
Conventions
| What | How |
|---|---|
| Amounts | Lamports for SOL, raw units for tokens (6 decimals). Values that can pass 2^53 are decimal strings like "1532805100615". Prices (priceSol, SOL per whole token) and percentages are numbers. |
| Times | Unix seconds. |
| Pages | List endpoints return nextCursor (null at the end); pass it back as ?cursor=. Trades use a keyset cursor, stable while new trades arrive. Candles page with before=nextBefore. |
| Coins | Public paths call coins tokens: /v1/tokens/.... status is curve, graduating or graduated. |
| Freshness | Trades are indexed from the chain within seconds. Holders are a snapshot every 10 minutes. Creator claimable fees are read live from the pools. |
| CORS | Every public route answers Access-Control-Allow-Origin: *. |
Reference
Coins and trades
#Coins, with filters, sort, search and pagination
GET/v1/tokens
Key optionalRate class readlistTokens
Parameters
| Name | Type | About |
|---|---|---|
| statusquery | "all" | "curve" | "graduating" | "graduated" | default "all" |
| creatorquery | address | Only coins created by this wallet. |
| qquery | string | Search ticker or name (contains), or an exact mint. max 64 chars |
| sortquery | "new" | "marketcap" | "volume24h" | "lastTrade" | "progress" | "trades" | default "new" |
| limitquery | integer | Page size, 1 to 100. default 50 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
Response TokenPage
| Field | Type | About |
|---|---|---|
| tokensrequired | TokenSummary[] | |
| mintrequired | address | |
| namerequired | string | |
| tickerrequired | string | |
| descriptionrequired | string | |
| imagerequired | string | null | Image URL (served by this API). |
| bannerrequired | string | null | 3:1 banner URL, site only, not on chain. |
| metadataUrirequired | string | null | The on-chain metadata URI (Metaplex JSON). |
| creatorrequired | address | |
| createdAtrequired | integer | Pool activation time. |
| statusrequired | "curve" | "graduating" | "graduated" | curve: trading on the bonding curve. graduating: curve full, migration pending. graduated: trading on DAMM v2. |
| curvePoolrequired | address | Meteora DBC virtual pool. |
| configrequired | address | DBC config (fee tier). |
| dammPoolrequired | address | null | Meteora DAMM v2 pool after graduation. |
| feesrequired | FeeSplit | |
| curveProgressPctrequired | number | Share of the graduation threshold raised, 0 to 100. |
| priceSolrequired | number | SOL per whole token, from the pool's sqrt price. |
| marketCapSolrequired | number | priceSol x 1,000,000,000 supply. |
| holderCountrequired | integer | |
| tradesrequired | integer | |
| volume24hLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| lastTradeAtrequired | integer | null | Unix time in seconds. |
| dexPaidrequired | boolean | Approved DEX Screener Enhanced Token Info order. |
| socialrequired | object | |
| totalrequired | integer | |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens?sort=volume24h&limit=20"#Every coin in one list (for terminals)
GET/v1/tokenlist
Key optionalRate class readgetTokenList
Mint, pools, config, creator, createdAt and status for every coin, newest first. Cached 30s.
Response TokenList
| Field | Type | About |
|---|---|---|
| namerequired | string | |
| timestamprequired | integer | Unix time in seconds. |
| countrequired | integer | |
| tokensrequired | object[] | |
| chainIdrequired | integer | |
| addressrequired | address | |
| namerequired | string | |
| symbolrequired | string | |
| decimalsrequired | integer | |
| logoURIrequired | string | null | |
| metadataUrirequired | string | null | |
| curvePoolrequired | address | |
| dammPoolrequired | address | null | |
| configrequired | address | |
| creatorrequired | address | |
| createdAtrequired | integer | Unix time in seconds. |
| statusrequired | "curve" | "graduating" | "graduated" | curve: trading on the bonding curve. graduating: curve full, migration pending. graduated: trading on DAMM v2. |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokenlist"#Coin detail: metadata, safety facts, curve, graduation, sniper window, totals
GET/v1/tokens/{mint}
Key optionalRate class readgetToken
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address |
Response TokenDetail
| Field | Type | About |
|---|---|---|
| mintrequired | address | |
| namerequired | string | |
| tickerrequired | string | |
| descriptionrequired | string | |
| imagerequired | string | null | Image URL (served by this API). |
| bannerrequired | string | null | 3:1 banner URL, site only, not on chain. |
| metadataUrirequired | string | null | The on-chain metadata URI (Metaplex JSON). |
| creatorrequired | address | |
| createdAtrequired | integer | Pool activation time. |
| statusrequired | "curve" | "graduating" | "graduated" | curve: trading on the bonding curve. graduating: curve full, migration pending. graduated: trading on DAMM v2. |
| curvePoolrequired | address | Meteora DBC virtual pool. |
| configrequired | address | DBC config (fee tier). |
| dammPoolrequired | address | null | Meteora DAMM v2 pool after graduation. |
| feesrequired | FeeSplit | |
| tierrequired | string | Tier key, e.g. creator-100, holders, split-50. |
| moderequired | "creator" | "holders" | "split" | Who earns the fee: the creator, holders, or both. |
| totalPctrequired | number | Total pool fee after the opening window, percent of the SOL side. |
| creatorPctrequired | number | |
| holdersPctrequired | number | |
| platformPctrequired | number | Pad share. 75% of it buys and burns $JUSTI, 25% goes to the dev wallet. |
| meteoraPctrequired | number | Meteora protocol share (20% of the pool fee). |
| creatorOnchainPercentrequired | integer | creatorTradingFeePercentage on the DBC config. |
| poolFeeNumeratorrequired | u64 string | Pool fee numerator over 1e9 after the window. |
| curveProgressPctrequired | number | Share of the graduation threshold raised, 0 to 100. |
| priceSolrequired | number | SOL per whole token, from the pool's sqrt price. |
| marketCapSolrequired | number | priceSol x 1,000,000,000 supply. |
| holderCountrequired | integer | |
| tradesrequired | integer | |
| volume24hLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| lastTradeAtrequired | integer | null | Unix time in seconds. |
| dexPaidrequired | boolean | Approved DEX Screener Enhanced Token Info order. |
| socialrequired | object | |
| xrequired | string | null | |
| telegramrequired | string | null | |
| websiterequired | string | null | |
| metadatarequired | TokenMetadata | null | Metaplex-standard token metadata JSON we host (the on-chain uri). |
| namerequired | string | |
| symbolrequired | string | |
| descriptionrequired | string | |
| imagerequired | string | |
| showNamerequired | boolean | |
| createdOnrequired | string | |
| string | ||
| telegram | string | |
| website | string | |
| banner | string | |
| createSignaturerequired | string | |
| safetyrequired | Safety | |
| fixedSupplyrequired | boolean | null | |
| mintAuthorityRevokedrequired | boolean | null | |
| freezeAuthorityRevokedrequired | boolean | null | |
| metadataImmutablerequired | boolean | null | |
| lpLockedPctrequired | number | Share of graduation LP that is permanently locked (100 on every justi config). |
| devBuyPctrequired | number | Dev buy in the create transaction, percent of supply. |
| devHoldsPctrequired | number | Creator wallet's balance at the last holder snapshot, percent of supply. |
| top10Pctrequired | number | Top 10 wallet holders, percent of supply, at the last snapshot. |
| holdersAtrequired | integer | null | Unix time in seconds. |
| curverequired | object | |
| quoteReserveLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| graduationQuoteLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| progressPctrequired | number | |
| graduationrequired | object | |
| graduatedrequired | boolean | |
| dammPoolrequired | address | null | |
| migratedAtrequired | integer | null | Unix time in seconds. |
| migrationSignaturerequired | string | null | |
| sniperWindowrequired | object | |
| secondsrequired | integer | Length of the opening window. |
| startPctrequired | number | Fee at second 0. |
| schedulerequired | object[] | Fee for each second of the window for this tier; after the last entry the tier fee applies. |
| extraSplitrequired | object | How the pad's share of the fee above the normal rate is split. |
| endsAtrequired | integer | Unix time in seconds. |
| feeNowPctrequired | number | |
| buyersrequired | integer | |
| boughtPctOfSupplyrequired | number | |
| extraFeeLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| totalsrequired | object | |
| volumeLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderRewardsLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderRoundsrequired | integer | |
| holderWalletsrequired | integer | |
| burnedTokensrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| creatorClaimedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| creatorUnclaimedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| dexrequired | object | |
| paidrequired | boolean | |
| checkedAtrequired | integer | null | Unix time in seconds. |
| urlrequired | string | |
| urlrequired | string |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>"#Metaplex metadata JSON for a coin
GET/v1/tokens/{mint}/metadata
Key optionalRate class readgetTokenMetadata
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address |
Response TokenMetadata
| Field | Type | About |
|---|---|---|
| namerequired | string | |
| symbolrequired | string | |
| descriptionrequired | string | |
| imagerequired | string | |
| showNamerequired | boolean | |
| createdOnrequired | string | |
| string | ||
| telegram | string | |
| website | string | |
| banner | string |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/metadata"#Trades, newest first, cursor paginated (curve and DAMM v2)
GET/v1/tokens/{mint}/trades
Key optionalRate class readlistTrades
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address | |
| limitquery | integer | Page size, 1 to 200. default 50 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
| walletquery | address | |
| sidequery | "buy" | "sell" | buy: SOL in, coin out. sell: coin in, SOL out. |
| venuequery | "curve" | "damm" | curve: the Meteora DBC bonding curve. damm: the Meteora DAMM v2 pool after graduation. |
Response TradePage
| Field | Type | About |
|---|---|---|
| tradesrequired | Trade[] | |
| signaturerequired | signature | Base58 transaction signature. |
| ixrequired | string | Instruction position in the transaction. With signature it is unique. |
| venuerequired | "curve" | "damm" | curve: the Meteora DBC bonding curve. damm: the Meteora DAMM v2 pool after graduation. |
| siderequired | "buy" | "sell" | buy: SOL in, coin out. sell: coin in, SOL out. |
| walletrequired | address | |
| solLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokenAmountrequired | u64 string | Raw token units (6 decimals). |
| priceSolrequired | number | null | Pool price right after the trade, SOL per whole token. |
| tsrequired | integer | Unix time in seconds. |
| slotrequired | integer | |
| inWindowrequired | boolean | Inside the opening sniper window. |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/trades?limit=20"#OHLCV candles from indexed trades
GET/v1/tokens/{mint}/candles
Key optionalRate class readgetCandles
Each candle opens at the previous close. Prices are SOL per whole token, volume in SOL. Page back with before=nextBefore.
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address | |
| tfquery | "1s" | "15s" | "1m" | "5m" | "15m" | "1h" | default "1m" |
| limitquery | integer | 10 to 1500, default 500 |
| beforequery | integer | Unix time; candles strictly before it. |
Response Candles
| Field | Type | About |
|---|---|---|
| mintrequired | address | |
| timeframerequired | string | |
| secondsrequired | integer | |
| activationTsrequired | integer | Unix time in seconds. |
| windowEndsTsrequired | integer | Unix time in seconds. |
| candlesrequired | object[] | |
| trequired | integer | Unix time in seconds. |
| openrequired | number | |
| highrequired | number | |
| lowrequired | number | |
| closerequired | number | |
| volumeSolrequired | number | |
| tradesrequired | integer | |
| hasMorerequired | boolean | |
| nextBeforerequired | integer | null | Unix time in seconds. |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/candles?limit=20"#Holders from the latest snapshot (every 10 minutes)
GET/v1/tokens/{mint}/holders
Key optionalRate class readlistHolders
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address | |
| limitquery | integer | Page size, 1 to 500. default 100 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
Response HolderPage
| Field | Type | About |
|---|---|---|
| mintrequired | address | |
| snapshotAtrequired | integer | null | Unix time in seconds. |
| holderCountrequired | integer | |
| holdersrequired | object[] | |
| rankrequired | integer | |
| ownerrequired | address | |
| amountrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| pctOfSupplyrequired | number | |
| isWalletrequired | boolean | false for pools and other program accounts |
| isCreatorrequired | boolean | |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/holders?limit=20"#Buybacks and burns of one coin, with signatures
GET/v1/tokens/{mint}/burns
Key optionalRate class readlistTokenBurns
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address | |
| limitquery | integer | Page size, 1 to 200. default 50 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
Response BuybackPage
| Field | Type | About |
|---|---|---|
| totalsrequired | object | |
| burnsrequired | integer | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokensBurnedrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| buybacksrequired | Buyback[] | |
| idrequired | string | |
| mintrequired | address | |
| tickerrequired | string | null | |
| kindrequired | "justi" | "coin" | justi: $JUSTI buyback. coin: sniper-window burn of this coin. |
| statusrequired | "planned" | "swapped" | "burned" | "held" | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokensBoughtrequired | u64 string | null | Unsigned integer as a decimal string (may exceed 2^53). |
| routerequired | string | null | |
| swapSignaturerequired | string | null | |
| burnSignaturerequired | string | null | |
| createdAtrequired | integer | Unix time in seconds. |
| burnedAtrequired | integer | null | Unix time in seconds. |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/burns?limit=20"Rewards and creators
#Holder reward rounds of one coin
GET/v1/tokens/{mint}/rewards
Key optionalRate class readgetTokenRewards
Parameters
| Name | Type | About |
|---|---|---|
| mintrequiredpath | address | |
| limitquery | integer | Page size, 1 to 200. default 50 |
Response TokenRewards
| Field | Type | About |
|---|---|---|
| mintrequired | address | |
| holdersPctrequired | number | |
| roundSecrequired | integer | |
| nextRoundAtrequired | integer | null | Unix time in seconds. |
| totalsrequired | object | |
| creditedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| roundsrequired | integer | |
| walletsrequired | integer | |
| roundsrequired | object[] | |
| idrequired | string | |
| poolLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| creditedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| walletsrequired | integer | |
| atrequired | integer | Unix time in seconds. |
Errors400 invalid_params401 unauthorized404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/tokens/<mint>/rewards?limit=20"#What a wallet earned from holding, and its payouts with signatures
GET/v1/wallets/{address}/rewards
Key optionalRate class readgetWalletRewards
Parameters
| Name | Type | About |
|---|---|---|
| addressrequiredpath | address | |
| limitquery | integer | Page size, 1 to 200. default 100 |
Response WalletRewards
| Field | Type | About |
|---|---|---|
| walletrequired | address | |
| totalsrequired | object | |
| earnedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| paidLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| owedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| minPayoutLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| coinsrequired | object[] | |
| mintrequired | address | |
| tickerrequired | string | |
| earnedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| roundsrequired | integer | |
| lastRoundAtrequired | integer | Unix time in seconds. |
| payoutsrequired | object[] | |
| idrequired | string | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| statusrequired | "planned" | "sent" | "confirmed" | |
| signaturerequired | string | null | |
| createdAtrequired | integer | Unix time in seconds. |
| confirmedAtrequired | integer | null | Unix time in seconds. |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/wallets/<wallet>/rewards?limit=20"#Confirmed holder payouts, newest first
GET/v1/payouts
Key optionalRate class readlistPayouts
Parameters
| Name | Type | About |
|---|---|---|
| limitquery | integer | Page size, 1 to 200. default 50 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
Response PayoutPage
| Field | Type | About |
|---|---|---|
| payoutsrequired | object[] | |
| idrequired | string | |
| walletrequired | address | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| signaturerequired | string | |
| confirmedAtrequired | integer | Unix time in seconds. |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/payouts?limit=20"#Creator stats: coins, fees earned and claimable (read live from the pools)
GET/v1/creators/{wallet}
Key optionalRate class readgetCreator
Parameters
| Name | Type | About |
|---|---|---|
| walletrequiredpath | address |
Response CreatorStats
| Field | Type | About |
|---|---|---|
| walletrequired | address | |
| totalsrequired | object | |
| coinsrequired | integer | |
| earnedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| claimableLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderRewardsLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| coinsrequired | object[] | |
| mintrequired | address | |
| namerequired | string | |
| tickerrequired | string | |
| imagerequired | string | null | |
| moderequired | "creator" | "holders" | "split" | Who earns the fee: the creator, holders, or both. |
| creatorPctrequired | number | |
| holdersPctrequired | number | |
| createdAtrequired | integer | Unix time in seconds. |
| graduatedrequired | boolean | |
| curveProgressPctrequired | number | |
| marketCapSolrequired | number | |
| holderCountrequired | integer | |
| tradesrequired | integer | |
| earnedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| claimableLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| claimedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderRewardsLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/creators/<wallet>"Platform
#All buybacks and burns ($JUSTI and sniper-window coin burns)
GET/v1/buybacks
Key optionalRate class readlistBuybacks
Parameters
| Name | Type | About |
|---|---|---|
| kindquery | "justi" | "coin" | |
| statusquery | "planned" | "swapped" | "burned" | "held" | |
| limitquery | integer | Page size, 1 to 200. default 50 |
| cursorquery | string | nextCursor from the previous page. max 400 chars |
Response BuybackPage
| Field | Type | About |
|---|---|---|
| totalsrequired | object | |
| burnsrequired | integer | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokensBurnedrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| buybacksrequired | Buyback[] | |
| idrequired | string | |
| mintrequired | address | |
| tickerrequired | string | null | |
| kindrequired | "justi" | "coin" | justi: $JUSTI buyback. coin: sniper-window burn of this coin. |
| statusrequired | "planned" | "swapped" | "burned" | "held" | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokensBoughtrequired | u64 string | null | Unsigned integer as a decimal string (may exceed 2^53). |
| routerequired | string | null | |
| swapSignaturerequired | string | null | |
| burnSignaturerequired | string | null | |
| createdAtrequired | integer | Unix time in seconds. |
| burnedAtrequired | integer | null | Unix time in seconds. |
| nextCursorrequired | string | null |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/buybacks?limit=20"#Platform totals
GET/v1/platform/stats
Key optionalRate class readgetPlatformStats
Response PlatformStats
| Field | Type | About |
|---|---|---|
| coinsrequired | integer | |
| graduatedrequired | integer | |
| coinsLast24hrequired | integer | |
| tradesrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| volumeLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| volume24hLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| traders24hrequired | integer | |
| padClaimedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderPaidLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| holderPaidWalletsrequired | integer | |
| justiBurnrequired | object | |
| lamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| tokensrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| coinBurnLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| creatorClaimedLamportsrequired | u64 string | Unsigned integer as a decimal string (may exceed 2^53). |
| nowrequired | integer | Unix time in seconds. |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/platform/stats"#Vanity (...JUST) mint pool status
GET/v1/mint-pool
Key optionalRate class readgetMintPool
Response MintPool
| Field | Type | About |
|---|---|---|
| suffixrequired | string | |
| availablerequired | integer | |
| readyrequired | boolean | |
| fallbackrequired | string |
Errors400 invalid_params401 unauthorized429 rate_limited500 internal
curl "https://api.justi.fun/v1/mint-pool"Metadata and images
#Metadata JSON by launch id (the uri stored on chain)
GET/v1/meta/{id}
No keyRate class assetgetLaunchMetadata
Parameters
| Name | Type | About |
|---|---|---|
| idrequiredpath | string | UUID. |
Response TokenMetadata
| Field | Type | About |
|---|---|---|
| namerequired | string | |
| symbolrequired | string | |
| descriptionrequired | string | |
| imagerequired | string | |
| showNamerequired | boolean | |
| createdOnrequired | string | |
| string | ||
| telegram | string | |
| website | string | |
| banner | string |
Errors400 invalid_params404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/meta/<id>"#Coin image by launch id
GET/v1/image/{id}
No keyRate class assetgetLaunchImage
Parameters
| Name | Type | About |
|---|---|---|
| idrequiredpath | string | UUID. |
Response: image/*
Errors400 invalid_params404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/image/<id>" -o out#3:1 banner by coin mint (or by launch id before it goes live)
GET/v1/banner/{key}
No keyRate class assetgetBanner
Parameters
| Name | Type | About |
|---|---|---|
| keyrequiredpath | string | max 64 chars |
| vquery | string | Version from the banner URL; a matching v is cached for a year. max 32 chars |
Response: image/*
Errors400 invalid_params404 not_found429 rate_limited500 internal
curl "https://api.justi.fun/v1/banner/<mint or launchId>" -o out