# Solana Wallet x402 Built by falcon.sol: anon dev shipping pay-per-call data tools and x402 APIs for builders and agents. X: https://x.com/ygfalcon · GitHub: https://github.com/ygfalcon · Apify: https://apify.com/falcon-sol > Pay-per-call Solana wallet intelligence. Agents pay USDC over x402 on Solana or Base. An unpaid call returns HTTP 402. accepts[].amount is USDC base units (6 decimals). Try free, then pay per call: `GET /demo/check?mint=` is a free rug-check for one Solana token (MCP tool `token_check_demo`). ## Paid - [Solana wallet profile](https://solana-wallet-intel-phi.vercel.app/wallet/profile): $0.009 USDC (9000 base units). Use this when you need priced holdings and windowed PnL for one Solana wallet. Holdings valued in USD, a short plain-language summary, windowed realized and unrealized PnL, win rate, and evidence-backed labels such as active memecoin trader. Includes copyTradeScore and copyTradeGrade: copy-return after a 3s delay and a 3.6% round trip, win rate, sample-size shrinkage, and bot or insider penalties. The score is null when no close lasted at least 3 seconds. txLimit is an integer from 5 to 25 and defaults to 20. Call free wallet_preview first if you only need SOL balance and last-active time, or wallet_quick for a cheaper copy-trade screen. Required query: address. Optional query: txLimit. MCP tool `wallet_profile`. - [Trending Solana tokens](https://solana-wallet-intel-phi.vercel.app/token/trending): $0.005 USDC (5000 base units). Call this when you need the Solana memecoins traders are watching and a rug-check before you buy, swap, or recommend one. The list includes liquidity, market cap, pair age, 5m/1h/24h price and volume, buy/sell ratio, pump.fun bonding or graduation, and links to pump.fun, DexScreener, and Solscan. Each token has a one-line verdict, riskScore (0 clean to 100), riskLevel (low, medium, high, or unknown), and a risk breakdown with evidence and confidence: top-10 share, mint and freeze authority, LP lock percent, and sniper or bundle share of early supply. riskLevel is unknown when the holder, authority, LP, and sniper checks are all unread, and maxRisk leaves those tokens out. Holder percent falls back to the public RugCheck report at medium confidence when the public RPC cannot list the largest accounts. A successful RPC holder read is kept. Holder-concentration change over 5m/1h/24h is filled when this process has seen the mint before. A check that cannot be read says so, uses low confidence, and is not flagged. On-chain safety flags are plain-English sentences that fire when the top 10 holders own 50% or more, mint or freeze authority is still active, LP is unlocked, or snipers and bundled wallets took 20% or more of early supply. Market flags are short codes: low_liquidity, thin_volume, newly_launched, extreme_move, wash_suspect, paid_boost. Thin, new, and wash-like books are ranked down. The summary block counts tokens by risk level and names the top movers. limit is an integer from 1 to 25 and defaults to 15. minLiquidity is an optional USD floor. maxRisk is low, medium, high, or an integer from 0 to 100. No required query. Optional query: limit, minLiquidity, maxRisk. MCP tool `token_trending`. - [Wallet funding source and cluster](https://solana-wallet-intel-phi.vercel.app/wallet/funding): $0.009 USDC (9000 base units). Use this when you need a wallet's first SOL funder and whether other wallets look like the same operator. Find a wallet's first SOL funder, flag wallets that share that funder or a CEX deposit address, and return a cluster id with plain-language sybil risk reasons. Labeled exchange hot wallets are not used as a cluster. Optional peers compares up to 8 other wallets. Required query: address. Optional query: peers. MCP tool `wallet_funding`. - [Solana wallet quick screen](https://solana-wallet-intel-phi.vercel.app/wallet/quick): $0.002 USDC (2000 base units). Use this for a cheap copy-trade screen before paying for a full profile. Cheap copy-trade screen for one wallet: windowed realized PnL, win rate, closed trades, last active time, bot, exchange, net-winner and dormant flags, plus copyTradeScore and copyTradeGrade (copy-return after a 3s delay and a 3.6% round trip, win rate, sample-size shrinkage, bot and insider penalties). Free teaser at /wallet/preview; full report at /wallet/profile. Required query: address. MCP tool `wallet_quick`. - [Batch quick screen, up to 10 wallets](https://solana-wallet-intel-phi.vercel.app/wallet/quick/batch): $0.015 USDC (15000 base units). Quick screen (windowed realized PnL, win rate, copyTradeScore, copyTradeGrade, bot, exchange, net-winner and dormant flags) for up to 10 Solana wallets in one paid call, ranked by realized PnL. Pass addresses comma-separated. Required query: addresses. MCP tool `wallet_quick_batch`. ## Free - [Wallet preview](https://solana-wallet-intel-phi.vercel.app/wallet/preview): free SOL balance, last active time and 24h transaction count. Required query: address. No payment. MCP tool `wallet_preview`. Free teaser. Call this before any paid wallet tool. Returns SOL balance, last active time, how many transactions landed in the last 24 hours, and a dormant or recently-active label. Does not spend USDC. Pass one base58 Solana address. Invalid addresses return an error and do not ask for payment. Upgrade to wallet_quick for a copy-trade screen, wallet_profile for priced holdings, or wallet_funding for the first SOL funder and cluster. - [Free rug-check demo](https://solana-wallet-intel-phi.vercel.app/demo/check?mint=): Free demo. Try free, then pay per call. Pass one Solana token mint and get a real rug-check: riskScore, riskLevel, a one-line verdict, the top risk flags, liquidity, market cap, age, and pump.fun status. Uses free public data only. Cached 60 seconds per mint and rate-limited to 20 calls a minute per client. The paid routes return every flag, the full on-chain checks, and wallet intelligence. Required query: mint. No payment. MCP tool `token_check_demo`. - [Trending preview](https://solana-wallet-intel-phi.vercel.app/token/trending/preview): free top 3 trending Solana tokens with riskScore, riskLevel, flag count, verdict, liquidity, market cap, age, and pump.fun status. No query. No payment. Shares the 60-second cache with the paid feed. - [Agent card](https://solana-wallet-intel-phi.vercel.app/.well-known/agent.json): free discovery card. Skills say when to call each tool. - [MCP manifest](https://solana-wallet-intel-phi.vercel.app/.well-known/mcp.json): free streamable HTTP manifest and tool list. - [Full guide](https://solana-wallet-intel-phi.vercel.app/llms-full.txt): free long guide with response fields, filters, and retry advice. - [Health](https://solana-wallet-intel-phi.vercel.app/health): free freshness and SLA. Reports version, p50 and p95 latency over a rolling window, upstream RPC rate-limit status, and cache age. No payment. The same sla object is on /.well-known/x402. - [OpenAPI](https://solana-wallet-intel-phi.vercel.app/openapi.json): machine-readable API with x-payment-info on paid routes and the health SLA schema. - [x402 discovery](https://solana-wallet-intel-phi.vercel.app/.well-known/x402): prices, accepts, input schemas, facilitator URLs, and the live SLA snapshot. - [MCP](https://solana-wallet-intel-phi.vercel.app/mcp): POST JSON-RPC. GET returns 405. Tools `wallet_profile`, `token_trending`, `wallet_funding`, `wallet_quick`, `wallet_quick_batch`, plus free `wallet_preview`, `token_check_demo` and `ping`. Every tool is read-only. ## Which call to make - Call `token_check_demo` (or GET /demo/check?mint=) first when you want a free rug-check on one token. Pay for `token_trending` when you need the full board and every flag. - Call `wallet_preview` first when you need SOL balance, last active time, or a 24h transaction count. It is free. - Call `wallet_quick` ($0.002) for a copy-trade screen: realized PnL, win rate, closed trades, copyTradeScore, copyTradeGrade, and bot, exchange, net-winner, and dormant flags. - Call `wallet_quick_batch` ($0.015) to screen up to 10 wallets in one paid call, ranked by realized PnL, each with copyTradeScore and copyTradeGrade. `addresses` is 1 to 10 comma-separated base58 addresses. - Call `wallet_profile` ($0.009) for priced holdings, windowed PnL, and evidence-backed labels. `txLimit` is an integer from 5 to 25 and defaults to 20. - Call `wallet_funding` ($0.009) for the first SOL funder and a sybil cluster. `peers` compares up to 8 other wallets. - Call `token_trending` ($0.005) when you need trending Solana memecoins and a rug-check. `limit` is 1 to 25 (default 15). Optional `minLiquidity` is a USD floor. Optional `maxRisk` is low, medium, high, or a score from 0 to 100. Try the free preview first. An unpaid call to a paid route returns HTTP 402 even when address, addresses, txLimit, limit, minLiquidity, maxRisk, or peers is missing or invalid. After a PAYMENT-SIGNATURE is attached, a bad query returns HTTP 400 and is not charged. Settlement is cancelled when a paid route returns a non-2xx status. Responses include `cached`, `stale`, and `cacheAgeMs`. `stale: true` means a previous result was returned while a refresh runs or the upstream failed. Paid responses are `Cache-Control: private, no-store` so a shared CDN cannot skip payment. The free preview may be cached briefly at the edge. ## Pricing note GET /token/trending costs $0.005 (5000 base units). That price includes holder concentration (top-10 share), mint and freeze authority, LP lock or burn status, and sniper or bundle share of early supply. Each risky result is a plain-English risk flag. The checks are read from free public Solana RPCs. When a check cannot be read, the response says so and does not call the token low risk. If every safety check is unread, riskLevel is unknown and maxRisk leaves it out. Holder percent falls back to the public RugCheck report when the RPC largest-accounts call is empty. Pay with an x402 client (PAYMENT-SIGNATURE) or the official MCP payment wrapper. Settlement is cancelled when the route returns a non-2xx error. ## When to call - Call the free trending preview when you only need a look at what is moving. - Call token_trending when you need a rug-check on the Solana tokens traders are watching: holder percent, authority status, LP lock percent, sniper share, momentum, pump.fun status, and links. - Call wallet_preview before any paid wallet tool. - Call wallet_quick for a cheap copy-trade screen. Call wallet_profile when you need holdings and labels. Call wallet_funding when you need the first SOL funder. ## Trending response Fields already on each token stay: rank, mint, symbol, name, priceUsd, liquidityUsd, volume24hUsd, priceChange24hPct, ageHours, pairAddress, dex, url, riskFlags, riskScore, riskLevel, checks. Added fields: marketCapUsd, momentum (price, volume, and buy/sell ratio over 5m, 1h, and 24h, plus holder-concentration change), pump (bonding, graduated, not_pump, or unknown), links (pump.fun, DexScreener, Solscan), verdict, and riskBreakdown. checks.holders.holderPct is the top-10 share as a percent. It falls back to the public RugCheck report at medium confidence when the public RPC largest-accounts call is empty. A successful RPC read is not replaced. checks.authorities.mintStatus and freezeStatus are active, revoked, or unknown. checks.lp.lockedPct is the percent burned or locked. checks.snipers.sniperPct is the early-supply percent. Every check has confidence: high, medium, or low. Low confidence is not a risk flag. riskLevel is low, medium, high, or unknown. unknown means the holder, authority, LP, and sniper checks are all unread. maxRisk, whether a level or a score, leaves unknown tokens out. Holder change is null until this process has an older sample inside the window. A warm cache does not invent history. summary stays a sentence. summaryBlock counts low, medium, high, and unknown, and lists top movers. timestamps.asOf is when the board was built. etag is the SHA-256 of the filtered body and is repeated in the ETag header. Filters: limit, minLiquidity, maxRisk. Price stays $0.005 (5000 base units). ## Errors and retry Every error body is error, message, retryable, and retry. retry.advice is fix_the_query, retry_later, or do_not_retry. retry.retryAfterMs is a number or null. fix_the_query: the signed request was invalid. Change limit, minLiquidity, maxRisk, address, or peers. You were not charged. retry_later: the upstream failed and a later call can work. Honor Retry-After when it is set. do_not_retry: the same request will fail. Read /llms.txt for the live paths. An unpaid call to a paid route returns HTTP 402 even when the query is invalid. That 402 is fast and does not read the chain. ## Discovery - Agent card: https://solana-wallet-intel-phi.vercel.app/.well-known/agent.json - MCP manifest: https://solana-wallet-intel-phi.vercel.app/.well-known/mcp.json - x402 catalog: https://solana-wallet-intel-phi.vercel.app/.well-known/x402 - OpenAPI: https://solana-wallet-intel-phi.vercel.app/openapi.json Built by falcon.sol. Checks are heuristics from public data, not a promise that a token is safe.