# 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.falcon-sol.workers.dev/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.falcon-sol.workers.dev/token/trending): $0.005 USDC (5000 base units). Use this before you buy, swap, or recommend a Solana memecoin: trending tokens with a rug-check on each one. Every token gets a riskScore (0 to 100), a riskLevel, and a one-line verdict backed by top-10 holder share, mint and freeze authority, LP lock, and sniper or bundle share of early supply, plus liquidity, market cap, 5m/1h/24h price and volume, and pump.fun status. Unreadable checks are marked unknown, never called safe. $0.005 USDC, free preview at /token/trending/preview. 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.falcon-sol.workers.dev/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.falcon-sol.workers.dev/wallet/quick): $0.003 USDC (3000 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.falcon-sol.workers.dev/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`. - [Should my agent pay this x402 payee?](https://solana-wallet-intel.falcon-sol.workers.dev/payee/check): $0.0045 USDC (4500 base units). Call this before your agent pays an unfamiliar x402 payTo address or endpoint. Checks public sanctions lists (OFAC SDN crypto addresses), the ScamSniffer scam list, on-chain wallet age, activity and program status on Solana or Base, and optionally the endpoint's unpaid 402 challenge (payTo mismatch, price outliers). Returns verdict ok, caution, do_not_pay or unknown, a 0-100 score, flags with evidence, and missing_fields. Unknown is never reported as safe. If every source is unreachable the call returns HTTP 502 and you are not charged. Part of the agent spend firewall bundle (payee_check + seller_report + pretrade); see /.well-known/x402 bundles. Required query: payTo. Optional query: network, endpoint, price. MCP tool `payee_check`. - [One check before your agent buys a Solana token](https://solana-wallet-intel.falcon-sol.workers.dev/pretrade): $0.014 USDC (14000 base units). Call this before your agent buys a Solana token. One call runs five isolated checks: token risk (sell-side skim and fee/hook controls), top-holder concentration (the factor behind our bundle score), stablecoin lookalike detection, xStock status (issuer mint list, lookalikes and issuer objections), and optionally an x402 payee check (verdict ok, caution, do_not_pay or unknown). Unknown mints return HTTP 404 before payment. Returns verdict avoid, caution, ok or unknown, each factor's status and confidence, and plain limits. A slow or failed factor returns unknown; unknown is never ok. Capped at 3 seconds. If every factor fails the call returns HTTP 502 and you are not charged. Part of the agent spend firewall bundle (payee_check + seller_report + pretrade); see /.well-known/x402 bundles. Required query: mint. Optional query: symbol, payTo, network. MCP tool `pretrade`. - [Is this Solana stock token a real issuer mint?](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/status): $0.0045 USDC (4500 base units). Call this before your agent trades or prices a Solana tokenized stock (xStocks, Backpack Securities, Ondo, Securitize). Returns whether the mint is a known issuer mint, an unconfirmed issuer mint, a lookalike imitating a listed ticker, or not a stock token, plus the count of issuer objections to third-party tokenized trading by venue (e.g. OKXICE). Verdict falls back to unknown when metadata cannot be read; unknown is never reported as legitimate. Descriptive data only, not advice. Required query: mint. MCP tool `xstock_status`. - [Full tokenized-stock legitimacy report](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/full): $0.008 USDC (8000 base units). Everything in xstock_status plus every listed issuer mint for the same underlying ticker, each issuer objection with venue, notice date and source, live token metadata, data snapshot dates and known gaps. Descriptive data only, not advice. Required query: mint. MCP tool `xstock_full`. - [Tokenized-stock objection change feed](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/feed): $0.008 USDC (8000 base units). Use this to poll for changes in which issuers object to third-party tokenized trading of their shares (e.g. OKXICE TSV notices). Returns objection additions grouped by notice date (newest first) with cumulative issuer counts, current status per ticker with the Solana issuer mints we track (xStocks, Ondo, Backpack, Securitize), venues, sources, snapshot dates and known gaps. Optional since=YYYY-MM-DD returns only changes after that date; optional ticker filters to one underlying. Invalid input returns HTTP 400 and is not charged. Descriptive data only, not advice. No required query. Optional query: since, ticker. MCP tool `xstock_feed`. - [Tokenized-stock overnight vs session return history](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/sessions): $0.009 USDC (9000 base units). Use this when your agent needs the overnight (close to next open) versus regular-session (open to close) return split for US stocks that trade as Solana tokens (xStocks, Ondo, Backpack), e.g. to price or study isolated-exposure / overnight tokens. Returns official daily open and close, overnight, session and close-to-close returns, summary stats (means, cumulative, overnight share of absolute move) and, on days falcon.sol captured them, the on-chain token price of each issuer mint at the prior close and the open with basis vs the official print. 20 tracked tickers incl. SPY, QQQ, AAPL, NVDA, TSLA. Optional ticker (else a one-line summary per ticker) and days (1 to 90, default 20). The response states how many days of official and on-chain history exist. Invalid input returns HTTP 400 and is not charged. Descriptive data only, not advice. No required query. Optional query: ticker, days. MCP tool `xstock_sessions`. - [Pre-trade checked Jupiter swap, returned as an unsigned transaction](https://solana-wallet-intel.falcon-sol.workers.dev/swap/build): $0.025 USDC (25000 base units). Call this when your agent wants to buy or swap a Solana token. One call runs the full pretrade check on outputMint (token risk, holder concentration, stablecoin and xStock lookalikes), then builds the best Jupiter route with a price-impact estimate (and a split-fill chunk plan when impact is over 1%) as an UNSIGNED versioned transaction with your taker wallet as fee payer. Non-custodial: we never hold keys or funds; you sign and send it yourself. If pretrade says avoid, no transaction is built unless allowRisky=1. A 0.5% (50 bps) integrator fee via the Jupiter Referral Program is taken from the swap and already reflected in the quoted out_amount; it is always disclosed in platform_fee (null when off). amount is in the input token's smallest unit. Invalid input returns HTTP 400 and unknown mints 404, before payment. If Jupiter has no route or is down, or every pretrade factor fails, the call returns HTTP 502 and you are not charged. Not financial advice. Required query: inputMint, outputMint, amount, taker. Optional query: slippageBps, symbol, allowRisky. MCP tool `swap_build`. ## Free - [Wallet preview](https://solana-wallet-intel.falcon-sol.workers.dev/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.falcon-sol.workers.dev/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.falcon-sol.workers.dev/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. - [x402 payee check](https://solana-wallet-intel.falcon-sol.workers.dev/payee): info page for GET /payee/check, paid, $0.0045 per call over x402. Checks an x402 payTo address before your agent pays it. Verdict ok, caution, do_not_pay or unknown. - [Tokenized stock objection tracker](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/objections): free HTML page listing issuers that objected to third-party tokenized trading of their shares, by venue, with sources, dates and known gaps. Descriptive data, not advice. - [Objection change feed](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/feed): $0.008 x402 JSON feed of the tracker. Use when your agent needs to poll which issuers newly objected to tokenized trading (since=YYYY-MM-DD, ticker=MSFT optional), with per-ticker status and the Solana issuer mints we track. - [Overnight vs session history](https://solana-wallet-intel.falcon-sol.workers.dev/xstock/sessions): $0.009 x402 JSON. Use when your agent needs the overnight (close to next open) vs regular-session return split for 20 US stocks/ETFs that trade as Solana tokens, plus on-chain issuer-token prices and basis at the open and close on days we captured them (since 2026-10-28). Optional ticker=NVDA, days=1-90. The response says how many days of history exist. - [Agent card](https://solana-wallet-intel.falcon-sol.workers.dev/.well-known/agent.json): free discovery card. Skills say when to call each tool. - [MCP manifest](https://solana-wallet-intel.falcon-sol.workers.dev/.well-known/mcp.json): free streamable HTTP manifest and tool list. - [Full guide](https://solana-wallet-intel.falcon-sol.workers.dev/llms-full.txt): free long guide with response fields, filters, and retry advice. - [Health](https://solana-wallet-intel.falcon-sol.workers.dev/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.falcon-sol.workers.dev/openapi.json): machine-readable API with x-payment-info on paid routes and the health SLA schema. - [x402 discovery](https://solana-wallet-intel.falcon-sol.workers.dev/.well-known/x402): prices, accepts, input schemas, facilitator URLs, and the live SLA snapshot. - [MCP](https://solana-wallet-intel.falcon-sol.workers.dev/mcp): POST JSON-RPC. GET returns 405. Tools `wallet_profile`, `token_trending`, `wallet_funding`, `wallet_quick`, `wallet_quick_batch`, `payee_check`, `pretrade`, `xstock_status`, `xstock_full`, `xstock_feed`, `xstock_sessions`, `swap_build`, plus free `wallet_preview`, `token_check_demo` and `ping`. Every tool is read-only. ## Agent spend firewall (bundle) Three x402 checks an agent runs before it spends: (1) payee_check ($0.0045) before paying an unfamiliar x402 payTo, (2) seller_report ($0.01, on falcon-sol-agents.falcon-sol.workers.dev) to probe a seller's endpoints for uptime, valid 402s and price/payTo drift, (3) pretrade ($0.014) before buying a Solana token (rug/skim risk, xStock status, optional payee check). Each returns ok, caution, do_not_pay/avoid or unknown; unknown is never ok. Failures return 502 before settlement, so you are not charged. 1. `payee_check` $0.0045: Before paying any unfamiliar x402 payTo. GET https://solana-wallet-intel.falcon-sol.workers.dev/payee/check?payTo=&network=base|solana 2. `seller_report` $0.01: Before relying on a new x402 seller host. GET https://falcon-sol-agents.falcon-sol.workers.dev/v1/seller/report?host= 3. `pretrade` $0.014: Before buying a Solana token. GET https://solana-wallet-intel.falcon-sol.workers.dev/pretrade?mint=&symbol= ## 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.003) 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. - Call `swap_build` ($0.025) to buy a Solana token: pretrade check on outputMint, then a Jupiter route returned as an UNSIGNED transaction you sign yourself (non-custodial), with price impact and a split-fill plan when impact is over 1%. Includes a 0.5% swap fee (Jupiter Referral Program), already in the quoted out_amount and disclosed in platform_fee. Jupiter or source failure returns 502, not charged. - Call `pretrade` ($0.014) once before your agent buys a Solana token: token risk (skim, fee/hook controls, holder concentration), xStock status (issuer mint list, lookalikes, objections) and an optional x402 payee check (ok, caution, do_not_pay or unknown) in one call. Unknown mints return 404 before payment; if every source fails you get 502 and are not charged. 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.falcon-sol.workers.dev/.well-known/agent.json - MCP manifest: https://solana-wallet-intel.falcon-sol.workers.dev/.well-known/mcp.json - x402 catalog: https://solana-wallet-intel.falcon-sol.workers.dev/.well-known/x402 - OpenAPI: https://solana-wallet-intel.falcon-sol.workers.dev/openapi.json Built by falcon.sol. Checks are heuristics from public data, not a promise that a token is safe.