{"uid":"cap_wbu-Te_YZht514OJEyzQd","slug":"argos-bot-cts-bridge-api-direct-lookup-98a7f9f0","name":"Argos Bot CTS Bridge API – Direct Lookup","description":"Look up bridges, create ownerless wrappers and bridge tokens between Arc and Base using Circle’s CTS and CCTP infrastructure.","url":"https://bridge-api.argosbot.io/v1/lookup/direct?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["token"],"properties":{"chain":{"enum":["arc","base","5042","8453"],"type":"string","description":"Chain containing the input address; omit to inspect both Arc and Base."},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Original or wrapped ERC-20 contract address to check. Replace the example with any Arc or Base token address."},"finality":{"enum":["latest","finalized"],"type":"string","default":"latest","description":"Block finality used for the lookup."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["requestId","result","payment"],"properties":{"result":{"type":"object","properties":{"cached":{"type":"boolean"},"status":{"enum":["complete","ambiguous","unavailable"]},"cacheAgeMs":{"type":"integer"},"candidates":{"type":"array","items":{"type":"object","properties":{"error":{"type":"string"},"source":{"type":"object","required":["address","chainId","chain","role","isBridgedRepresentation"],"properties":{"name":{"type":"string"},"role":{"enum":["original","wrapped"],"type":"string"},"chain":{"enum":["Arc","Base"],"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chainId":{"enum":[5042,8453],"type":"integer"},"decimals":{"type":"integer"},"explorerUrl":{"type":"string"},"isBridgedRepresentation":{"type":"boolean"}}},"status":{"enum":["not_a_contract","not_registered","wrapper_missing","verified","verification_failed","unavailable"],"type":"string"},"wrapped":{"anyOf":[{"type":"object","required":["address","chainId","chain","role","isBridgedRepresentation"],"properties":{"name":{"type":"string"},"role":{"enum":["original","wrapped"],"type":"string"},"chain":{"enum":["Arc","Base"],"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chainId":{"enum":[5042,8453],"type":"integer"},"decimals":{"type":"integer"},"explorerUrl":{"type":"string"},"isBridgedRepresentation":{"type":"boolean"}}},{"type":"null"}]},"evidence":{"type":"array","items":{"type":"object"}},"original":{"type":"object","required":["address","chainId","chain","role","isBridgedRepresentation"],"properties":{"name":{"type":"string"},"role":{"enum":["original","wrapped"],"type":"string"},"chain":{"enum":["Arc","Base"],"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chainId":{"enum":[5042,8453],"type":"integer"},"decimals":{"type":"integer"},"explorerUrl":{"type":"string"},"isBridgedRepresentation":{"type":"boolean"}}},"contracts":{"type":"array","items":{"type":"object"}},"direction":{"type":"string"},"operation":{"enum":["lock_and_mint","burn_and_unlock"]},"destination":{"anyOf":[{"type":"object","required":["address","chainId","chain","role","isBridgedRepresentation"],"properties":{"name":{"type":"string"},"role":{"enum":["original","wrapped"],"type":"string"},"chain":{"enum":["Arc","Base"],"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"chainId":{"enum":[5042,8453],"type":"integer"},"decimals":{"type":"integer"},"explorerUrl":{"type":"string"},"isBridgedRepresentation":{"type":"boolean"}}},{"type":"null"}]},"operational":{"type":"object"},"wrappedSupply":{"type":["object","null"],"properties":{"raw":{"type":"string"},"chainId":{"type":"integer"},"meaning":{"type":"string"},"decimals":{"type":"integer"},"formatted":{"type":"string"},"tokenAddress":{"type":"string"}}},"connectionExists":{"type":["boolean","null"]},"ownerlessVerified":{"type":["boolean","null"]}}}},"observedAt":{"type":"string","format":"date-time"}}},"payment":{"type":"object","description":"Facilitator settlement acknowledgement; Gateway batching is not necessarily a final onchain transfer."},"requestId":{"type":"string"}}}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Q1TZiUAMGG3fRX4pbIq2d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x3600000000000000000000000000000000000000","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up the bridge relationship of an ERC-20 token address between Arc and Base chains, returning wrapper and original token details via Circle's CTS infrastructure.","exampleAgentPrompt":"Can you check if the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base is registered as a bridged token between Arc and Base, using finalized block data?","exampleUseCases":[{"title":"Verify bridged token on Base","prompt":"Check whether 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base has a corresponding original token registered on Arc — tell me the source and wrapped token details if they exist."},{"title":"Resolve Arc token's bridge counterpart","prompt":"I have this Arc token address 0x1234567890abcdef1234567890abcdef12345678 — can you find out what its wrapped version looks like on Base using finalized block finality?"},{"title":"Audit bridge registration for a DeFi token","prompt":"Look up the bridge status of ERC-20 token 0xdAC17F958D2ee523a2206206994597C13D831ec7 across both Arc and Base — I need to know if it's registered, what its role is, and whether any wrapper is missing."}],"resultDescription":"Returns a JSON object with requestId, payment details, and a result object containing: bridge status (complete, ambiguous, or unavailable), cache info (cached flag and age in milliseconds), and a candidates array. Each candidate includes source token details (address, chainId, chain, role, symbol, decimals, explorerUrl, isBridgedRepresentation) and wrapped token details, plus a per-candidate verification status (verified, not_registered, wrapper_missing, not_a_contract, verification_failed, or unavailable).","failureModes":["Invalid token address format (must match ^0x[0-9a-fA-F]{40}$) returns validation error","Token not found on specified chain returns status 'not_registered'","Token address is not a contract returns status 'not_a_contract'","Wrapper contract missing returns status 'wrapper_missing'","CTS/CCTP infrastructure unavailable returns status 'unavailable'","Ambiguous result when token appears on both chains in conflicting states returns status 'ambiguous'","Payment failure (insufficient USDC) blocks request under x402 protocol"],"whenToPreferThis":"Use this endpoint when you need to programmatically resolve whether an ERC-20 token has a bridge relationship between Arc and Base chains, specifically using Circle's CTS infrastructure. Prefer this over generic block explorers when you need structured, machine-readable bridge status including wrapper addresses, roles, and verification states. Best suited for DeFi agents that need to validate token bridgeability before initiating cross-chain transfers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:32:26.524Z","isFirstParty":false,"canonicalSlug":"argos-bot-cts-bridge-api-direct-lookup-98a7f9f0"}