{"uid":"cap_R02tSwovQ3lhZraltJ_Bm","slug":"chainhilt-bridge-route-simulator-4d5649fb","name":"Chainhilt Bridge Route Simulator","description":"Compare bridge routes, best first: tokens, estimated and minimum target amounts, fees by token, duration, expiry and the approval each route needs. sourceAmount is exactly what leaves the wallet.","url":"https://chainhilt.ai/api/v1/bridge/simulate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"targetType":{"enum":["hyperCore","hyperEvm"],"type":"string","description":"HyperEVM targets only. hyperCore credits the recipient's HyperCore USDC balance; hyperEvm delivers the token on HyperEVM. Defaults to hyperCore for HyperEVM USDC or when hyperCoreBalance is set, otherwise hyperEvm."},"sourceToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Source token; the zero address (or 0xEeee…EEeE) bridges the chain's native token."},"targetToken":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Target token. It may differ from sourceToken, in which case the route swaps across tokens."},"sourceAmount":{"type":"string","pattern":"^[0-9]+$","maxLength":78,"description":"Exact base-unit amount that leaves the wallet. Every fee except native ones comes out of it."},"senderAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Optional wallet that will send the bridge; lets providers quote for it."},"sourceChainId":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"targetChainId":{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0},"excludedAdapters":{"type":"array","items":{"enum":["across","circleCctp","debridge","layerzero","relay","socket"],"type":"string"}},"hyperCoreBalance":{"enum":["perps","spot"],"type":"string","description":"HyperCore targets only. Defaults to perps."}}},"responseSchema":{"type":"json","example":{"errors":[{"adapter":"debridge","message":"deBridge cannot deliver to HyperCore, only to HyperEVM: set targetType to hyperEvm"}],"routes":[{"fees":[{"kind":"bridge","token":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"amount":"5900","paidFrom":"input"}],"adapter":"across","approval":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","spender":"0x09aea4b2242abC8bb4BB78D537A67a245A7bEC64"},"expiresAt":1790870627,"targetType":"hyperCore","adapterName":"Across","providerRef":"lh5r9-1790867234078-e436362840a7","sourceToken":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"targetToken":{"symbol":"USDC","address":"0xb88339CB7199b77E23DB6E890353E22632Ba630f","chainId":999,"decimals":6},"sourceAmount":"10000000","minTargetAmount":"9994056","hyperCoreBalance":"perps","estimatedTargetAmount":"9994056","estimatedDurationSeconds":2},{"fees":[{"kind":"forwarding","token":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"amount":"247562","paidFrom":"input"},{"kind":"protocol","token":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"amount":"1300","paidFrom":"input"}],"adapter":"circleCctp","approval":{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","spender":"0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d"},"targetType":"hyperCore","adapterName":"Circle CCTP","sourceToken":{"symbol":"USDC","address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chainId":8453,"decimals":6},"targetToken":{"symbol":"USDC","address":"0xb88339CB7199b77E23DB6E890353E22632Ba630f","chainId":999,"decimals":6},"sourceAmount":"10000000","minTargetAmount":"9751138","hyperCoreBalance":"perps","estimatedTargetAmount":"9751138","estimatedDurationSeconds":8}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jobt7yw6kXGrDgNdtRnkh","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Simulates and ranks cross-chain bridge routes for a given token transfer, returning estimated amounts, fees, durations, and approval requirements for each route.","exampleAgentPrompt":"Compare bridge routes for sending exactly 500000000 USDC (base units) from Ethereum (chain 1) to Arbitrum (chain 42161) — show me the best routes sorted by estimated received amount, including fees and how long each will take, and exclude the debridge adapter.","exampleUseCases":[{"title":"Cheapest ETH-to-Arbitrum USDC bridge","prompt":"I want to bridge 1000 USDC from Ethereum mainnet to Arbitrum and get the best rate — can you compare all the bridge routes, show me the fees and estimated arrival time for each, and tell me which one gives me the most USDC on the other side?"},{"title":"HyperCore balance top-up simulation","prompt":"Simulate bridging 2000000 USDC base units from Arbitrum (chain 42161) to HyperEVM targeting my HyperCore spot balance — compare the available routes and show me estimated amounts, fees, and how long each route takes."},{"title":"Native token bridge with adapter exclusions","prompt":"Compare cross-chain bridge routes for sending the native token on chain 10 (Optimism) to chain 8453 (Base), using my wallet 0xAbCd1234abcd1234abcd1234abcd1234abcd1234, but exclude the layerzero and socket adapters from the results."}],"resultDescription":"An ordered list of bridge routes, best-first, each containing: estimated and minimum target token amounts in base units, itemized fees per token, expected transfer duration, route expiry timestamp, required token approval details, and the adapter/provider powering that route.","failureModes":["Unsupported chain pair returns no routes or an error","sourceAmount of zero or non-integer string causes validation failure","Invalid token address format (not a valid 0x hex address) returns 400","All adapters excluded via excludedAdapters leaving no valid routes","Liquidity unavailable on requested route returns empty route list","sourceChainId or targetChainId not supported by any adapter","Rate limiting or payment failure due to x402 microtransaction issues"],"whenToPreferThis":"Use this endpoint when you need to compare multiple bridge providers side-by-side before committing to a transfer — it is a pure simulation with no side effects, so it is safe to call repeatedly to find the best route. Prefer it over a single-provider bridge quote when you want fee transparency, minimum-received guarantees, and ranked alternatives including HyperCore/HyperEVM-specific routing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:30:32.887Z","isFirstParty":false,"canonicalSlug":"chainhilt-bridge-route-simulator-4d5649fb"}