{"uid":"cap_N4oQse9v79AQg4m8zAe0q","slug":"solmachina-priority-fee-oracle-71801487","name":"SolMachina Priority Fee Oracle","description":"Before an AI agent executes on Solana, it asks SolMachina: risk + a decision (EXECUTE/REVIEW/REJECT) + an SMRI score + a signed receipt, paid per call over x402 in USDC. Trust-first — cites every source, says 'unknown' over guessing. No account, no API key.","url":"https://api.solmachina.com/v1/priority-fee","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"accounts":{"type":"string","description":"Optional comma-separated base58 addresses to narrow the fee sample to transactions that write-locked them (e.g. a hot AMM pool)."}}},"responseSchema":{"type":"object","properties":{"unit":{"type":"string"},"percentiles":{"type":"object","properties":{"p50":{"type":"integer"},"p75":{"type":"integer"},"p90":{"type":"integer"},"p99":{"type":"integer"}}},"suggestedBands":{"type":"object","properties":{"fast":{"type":"integer"},"normal":{"type":"integer"},"economy":{"type":"integer"},"aggressive":{"type":"integer"}}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8aJsDO0OE8Qw-3DT8BEMd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current Solana network priority fee percentiles and suggested fee bands (economy, normal, fast, aggressive) for optimal transaction prioritization","exampleAgentPrompt":"What priority fee should I use to get my Solana swap confirmed quickly right now — give me the fast and aggressive fee bands, and narrow the sample to this AMM pool: 58oQChx4yWmvKnvse9NqhUiLtKdnzjUcpAVQeZuKe5JF.","exampleUseCases":[{"title":"Optimizing urgent DeFi swap fees","prompt":"I'm about to execute a time-sensitive token swap on Solana — what priority fee should I set to make sure it lands in the next block? Check the aggressive and fast bands for me."},{"title":"AMM pool-specific fee estimation","prompt":"I'm submitting a liquidity transaction that write-locks this Raydium pool: 58oQChx4yWmvKnvse9NqhUiLtKdnzjUcpAVQeZuKe5JF — what priority fee should I use based on recent activity on that pool?"},{"title":"Cost-conscious background transaction","prompt":"I need to send a low-urgency Solana transaction and want to minimize fees — what's the economy fee band on the network right now so I'm not overpaying?"}],"resultDescription":"Returns a JSON object with the fee unit (typically micro-lamports), four percentile fee levels (p50, p75, p90, p99) reflecting recent on-chain activity, and four named suggested bands — economy, normal, fast, and aggressive — that the agent can directly use as the prioritizationFeeLamports value when submitting a Solana transaction.","failureModes":["Invalid or non-base58 account address returns a 400 error","Accounts parameter references an address with no recent write-lock history, yielding a sparse or fallback sample","Network congestion or RPC unavailability may cause 503 responses","Payment failure over x402 (insufficient USDC balance) blocks the call","Stale fee data if sampled during a low-activity window may underestimate required fees during sudden congestion spikes"],"whenToPreferThis":"Use this endpoint when an AI agent needs to set or recommend a Solana priority fee before submitting a transaction, especially in DeFi contexts where landing speed matters. It is superior to hard-coded fee defaults or generic RPC fee estimates because it returns percentile breakdowns and named bands that map directly to transaction urgency levels. The optional account-scoping feature makes it especially valuable for AMM interactions where pool-specific contention differs from global network fees. Requires no API key — payment is per-call via x402 USDC on Solana mainnet.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:32.041Z","isFirstParty":false}