{"uid":"cap_7YYVEcD5mtOSzoIF9NcTn","slug":"avasis-ethereum-transaction-unstick-3c6f40c3","name":"Avasis Ethereum Transaction Unstick","description":"Tx unstick on Ethereum (chain 1, $0.02): address (+ tx hash or nonce, urgency) -> stuck transaction diagnosis: confirmed vs pending nonce (nonce gap), tx state next / queued / superseded / mined, max fee below base fee, low tip; EIP-1559 replacement plan (+10 % rule, fee tier), ready-to-sign cancel + speed-up, cost ETH + USD, can_pay. Phrases: stuck transaction, tx unstick, replace transaction, cancel transaction, nonce gap. GET or POST JSON. Unknown hash + nothing pending -> 404, never charged.","url":"https://agents.avasis.ai/v1/eth/tx-unstick?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"tx":{"type":"string","description":"optional: the pending transaction hash to replace (0x + 64 hex); its state, fees and a ready-to-sign speed-up come from it"},"chain":{"type":"string","description":"optional; must be ethereum / 1 on this route"},"nonce":{"type":"integer","minimum":0,"description":"optional: the stuck nonce when you have no hash"},"address":{"type":"string","description":"the sender wallet of the stuck transaction (0x + 40 hex)"},"urgency":{"type":"string","description":"fee tier of the replacement: low / normal / high / next_block (default high)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["chain","address","verdict","nonces","fee_market","headline"],"properties":{"tx":{"type":["object","null"]},"cost":{"type":["object","null"]},"kind":{"type":"string"},"rail":{"type":"string"},"chain":{"type":"string"},"cancel":{"type":["object","null"]},"nonces":{"type":"object"},"address":{"type":"string"},"verdict":{"type":"object"},"chain_id":{"type":"integer"},"headline":{"type":"string"},"speed_up":{"type":["object","null"]},"fee_market":{"type":"object"},"replacement":{"type":["object","null"]},"block_number":{"type":"integer"},"also_available":{"type":"object"}}}}}}},"responseSchema":{"type":"json","example":{"tx":{"to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","hash":"0x5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c","type":"eip-1559","found":true,"input":{"args":{"amount_raw":"3720000","spender_or_to":"0x128b1240168fcb68bd2d98d718e559337722c93a"},"kind":"transfer","method":"transfer","selector":"0xa9059cbb","to_known":"USDC (Circle)","signature":"transfer(address,uint256)"},"mined":false,"nonce":499417,"state":"next","status":"pending","low_tip":true,"gas_limit":75000,"value_eth":"0","value_wei":"0","underpriced":true,"block_number":null,"queued_behind":0,"max_fee_per_gas_gwei":0.004,"max_priority_fee_per_gas_gwei":0.0001},"cost":{"note":"21000 gas at the replacement fees (max = authorized ceiling, expected = base fee + tip); excludes the Base L1 data fee (~$0.0003-0.001 per tx, priced by /v1/base/fee-plan); the speed-up costs its own gas limit x the same fees","eth_usd":2242.9,"cancel_max":{"eth":2.415e-7,"usd":0.00054166,"wei":"241500000000"},"balance_eth":"0.0421","balance_wei":"42100000000000000","price_source":"chainlink ETH/USD (latestRoundData)","can_pay_cancel":true,"cancel_expected":{"eth":1.365e-7,"usd":0.000306156,"wei":"136500000000"}},"kind":"tx-unstick","rail":"evm-tx-unstick-1","chain":"ethereum","reads":{"rpc":"fixture","calls":9,"elapsed_ms":7},"cancel":{"to":"0xf977814e90da44bfa03b6295a0616a897441acec","gas":"0x5208","data":"0x","from":"0xf977814e90da44bfa03b6295a0616a897441acec","note":"ready to sign from `from`: a 0-value self-transfer with the stuck nonce and the bumped fees; signing and broadcasting it drops the original","type":"0x2","nonce":"0x79ed9","value":"0x0","chainId":"0x2105","maxFeePerGas":"0xaf79e0","maxPriorityFeePerGas":"0x16e360"},"nonces":{"gap":4,"note":"pending = this node's pending-nonce view (no txpool RPC on public hosts): a gap of 0 can still hide a tx in a private mempool","pending":499421,"confirmed":499417,"mempool_visible":true},"address":"0xf977814e90da44bfa03b6295a0616a897441acec","verdict":{"level":"STUCK_UNDERPRICED","stuck":true,"action":"replace","reasons":["maxFeePerGas 0.004 gwei is below the current base fee 0.005 gwei: the tx cannot be included until the base fee drops; replace it with the same nonce 499417 at the fast tier (+10 % rule applied)"]},"chain_id":1,"headline":"STUCK UNDERPRICED on Base: maxFeePerGas 0.004 gwei is below the current base fee 0.005 gwei: the tx cannot be included until the base fee drops; replace it with the same nonce 499417 at the fast tier (+10 % rule applied); cancel = nonce 499417 at 0.0115 gwei max / 0.0015 gwei tip ($0.0003)","speed_up":{"to":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","gas":"0x124f8","data":"0xa9059cbb000000000000000000000000128b1240168fcb68bd2d98d718e559337722c93a000000000000000000000000000000000000000000000000000000000038c340","from":"0xf977814e90da44bfa03b6295a0616a897441acec","note":"the original call with the bumped fees (same nonce, to, value, data, gas): re-simulate before signing at /v1/base/tx-precheck","type":"0x2","nonce":"0x79ed9","value":"0x0","chainId":"0x2105","maxFeePerGas":"0xaf79e0","maxPriorityFeePerGas":"0x16e360"},"fee_market":{"tier":{"tier":"fast","when":"busy blocks: out-bid the median tip","max_fee_per_gas":{"wei":"11500000","gwei":0.0115},"max_priority_fee_per_gas":{"wei":"1500000","gwei":0.0015}},"urgency":"high","base_fee_gwei":0.005,"priority_gwei":0.001,"priority_basis":"node eth_maxPriorityFeePerGas"},"replacement":{"rule":"same nonce; maxPriorityFeePerGas AND maxFeePerGas each >= original x 1.10 (geth / op-geth), never below the chosen tier, maxFee >= 2 x base fee + priority","tier":"fast","basis":"fast tier already above +10 % of the original","nonce":499417,"urgency":"high","priority_basis":"node eth_maxPriorityFeePerGas","max_fee_per_gas":{"wei":"11500000","gwei":0.0115},"min_max_fee_gwei":0.004400001,"min_priority_fee_gwei":0.000110001,"max_priority_fee_per_gas":{"wei":"1500000","gwei":0.0015}},"block_number":53354727,"block_timestamp":1793498801}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5xJ8QBxLagCWsanB8c3jy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Diagnoses stuck Ethereum transactions and returns a ready-to-sign cancel or speed-up replacement plan with EIP-1559 fees","exampleAgentPrompt":"My Ethereum transaction from 0xf977814e90da44bfa03b6295a0616a897441acec with hash 0x5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c has been stuck for a while — can you diagnose why it's not confirming and give me a ready-to-sign cancel or speed-up transaction with high urgency?","exampleUseCases":[{"title":"Cancel stuck NFT mint transaction","prompt":"My wallet 0xf977814e90da44bfa03b6295a0616a897441acec has a stuck transaction with hash 0x5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c that's been pending for two hours — diagnose what's wrong and give me a ready-to-sign cancel transaction using next_block urgency."},{"title":"Fix nonce gap blocking new transactions","prompt":"I can't send any new Ethereum transactions from 0xf977814e90da44bfa03b6295a0616a897441acec because there's a nonce gap — my stuck nonce is 499417. Can you diagnose the issue and give me a replacement plan to clear it?"},{"title":"Speed up urgent token transfer","prompt":"I need to urgently speed up a pending USDC transfer from my Ethereum wallet 0xf977814e90da44bfa03b6295a0616a897441acec — the tx hash is 0x5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c5c. What are the EIP-1559 replacement fees and can I afford the speed-up with my current balance?"}],"resultDescription":"Returns a JSON object including the transaction's current state (next/queued/superseded/mined), nonce analysis (confirmed vs pending, gap size), fee market data (base fee vs max fee, low tip flag), a ready-to-sign cancel transaction object, a ready-to-sign speed-up transaction object, estimated cost in ETH and USD for each action, can_pay flags based on current wallet balance, and a human-readable headline summarizing the diagnosis.","failureModes":["Unknown tx hash with no pending transactions returns 404 (never charged)","Invalid Ethereum address format returns validation error","Missing required address parameter returns 400","Chain parameter not set to ethereum/1 returns routing error","RPC node unavailability may cause degraded diagnosis"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically diagnose and resolve a stuck Ethereum mainnet transaction. It is ideal when you have a wallet address and optionally a tx hash or nonce, and need a complete EIP-1559-compliant replacement plan including ready-to-sign cancel and speed-up transactions. Prefer this over manual gas estimation when you need nonce gap analysis, mempool visibility checks, and cost estimates in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:38:35.982Z","isFirstParty":false,"canonicalSlug":"avasis-ethereum-transaction-unstick-3c6f40c3"}