{"uid":"cap_rcTkkR9jM9as1vOPG4IE-","slug":"chainhilt-bridge-status-lookup-da88ecea","name":"ChainHilt Bridge Status Lookup","description":"Look up a bridge after its transaction was sent, by the adapter that built it and the hash of the bridge transaction on the source chain; layerzero and relay also need the providerRef that bridge/execute returned (0x and 64 hex characters). Poll it every 10 to 15 seconds until the status is filled, refunded or failed; an error answer, such as a 429, is not charged. After a 429, wait the Retry-After seconds.","url":"https://chainhilt.ai/api/v1/bridge/status?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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["adapter","sourceChainId","txHash"],"properties":{"txHash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","description":"Hash of the bridge transaction on the source chain (the last execute action, not the approval)."},"adapter":{"enum":["across","circleCctp","debridge","layerzero","relay","socket"],"type":"string","description":"The adapter that built the bridge: adapterId from bridge/execute."},"providerRef":{"type":"string","minLength":1,"description":"The route's providerRef from bridge/execute. Required for layerzero and relay, which look the transfer up by this id."},"sourceChainId":{"type":"integer","description":"EVM chain id the bridge transaction was sent on.","exclusiveMinimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["adapter","status"],"properties":{"detail":{"type":"string","description":"What the provider reports beyond the status: why it failed, where a refund went, or how funds can still be recovered. Show it to the user."},"status":{"enum":["not_found","pending","filled","refund_pending","refunded","failed"],"type":"string","description":"not_found: the provider has not indexed the transaction yet, which is normal for up to a minute after sending; for layerzero and relay, one that lasts means providerRef is not from the execute whose transaction was sent. pending: on its way. filled: delivered. refund_pending: it will not be delivered and the provider is refunding the sender. refunded: returned to the sender. failed: the provider reports a failure."},"adapter":{"enum":["across","circleCctp","debridge","layerzero","relay","socket"],"type":"string"},"refundTxHash":{"type":"string"},"targetTxHash":{"type":"string","description":"The delivery transaction on the target chain."},"providerStatus":{"type":"string","description":"The provider's own status, for reference."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"status":"filled","adapter":"circleCctp","targetTxHash":"0xa7d9fe3e3110c7f2d534069ed93ea4326ec05c450831dfeabe2342b9f65049d1","providerStatus":"COMPLETE"}},"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_1_26Qs8RYnw5O0vYLos49","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":"Poll the status of an in-flight cross-chain bridge transfer by adapter type, source chain, and transaction hash until it reaches a terminal state.","exampleAgentPrompt":"Check the status of my Across bridge transfer on Ethereum mainnet (chain ID 1) with tx hash 0xa7d9fe3e3110c7f2d534069ed93ea4326ec05c450831dfeabe2342b9f65049d1 — keep polling every 10 seconds until it shows filled, refunded, or failed.","exampleUseCases":[{"title":"Confirm Across bridge delivery","prompt":"I just sent a bridge transaction on Ethereum using Across, the tx hash is 0xa7d9fe3e3110c7f2d534069ed93ea4326ec05c450831dfeabe2342b9f65049d1 and the source chain ID is 1 — can you poll the bridge status every 10 seconds and tell me when it's filled or if something goes wrong?"},{"title":"Track LayerZero transfer with providerRef","prompt":"I did a LayerZero bridge on chain 42161 and the transaction hash is 0xb3c1fe3e3110c7f2d534069ed93ea4326ec05c450831dfeabe2342b9f65049d2 with providerRef 0xc4d2e... — please check the bridge status and keep retrying until it's no longer pending."},{"title":"Investigate a failed or refunded relay bridge","prompt":"My Relay bridge transfer on chain 10 with tx hash 0xd5e2fe3e3110c7f2d534069ed93ea4326ec05c450831dfeabe2342b9f65049d3 and providerRef 0xf6a7b... seems to have stalled — look up the status and tell me if it failed or was refunded and what the provider says about it."}],"resultDescription":"Returns a JSON object with the bridge adapter name, a normalized status enum (not_found, pending, filled, refund_pending, refunded, failed), the target chain transaction hash once available, the raw provider status string, and an optional detail field explaining failures, refunds, or recovery options.","failureModes":["not_found status returned when provider hasn't indexed the transaction yet (normal for up to ~1 minute after send)","429 rate limit — wait the Retry-After header duration before retrying (not billed)","providerRef missing or wrong for layerzero/relay adapters causes persistent not_found","invalid txHash format rejected by schema validation","failed status with detail field explaining irrecoverable error","refunded status indicating funds returned to sender without delivery"],"whenToPreferThis":"Use this endpoint after calling chainhilt bridge/execute to track the resulting cross-chain transfer to completion. It supports all major adapters (Across, Circle CCTP, deBridge, LayerZero, Relay, Socket) in a unified interface, making it the right choice when your agent needs a single polling loop across any adapter rather than integrating each bridge provider's native status API separately.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T18:35:01.647Z","isFirstParty":false,"canonicalSlug":"chainhilt-bridge-status-lookup-da88ecea"}