{"openapi":"3.1.0","info":{"title":"Argos Bot CTS Bridge Lookup","version":"1.0.0","description":"Look up any Arc or Base token’s ownerless bridge using Circle’s Crosschain Token Standard (CTS), CrossChainTokenService and CCTP. Get original and wrapped token addresses, wrapped supply, contracts and verification status.","x-logo":{"url":"https://www.argosbot.io/brand/argos-dog-social-profile.png","altText":"Argos Bot"}},"servers":[{"url":"https://arcus-api.argosbot.io"}],"externalDocs":{"description":"Official Arc contract references for Circle CrossChainTokenService and CCTP","url":"https://docs.arc.io/arc/references/contract-addresses"},"x-official-references":[{"title":"Circle: Crosschain Token Standard (CTS) and Cross-Chain Transfer Protocol (CCTP)","url":"https://www.circle.com/cross-chain-transfer-protocol"},{"title":"Arc Docs: CrossChainTokenService contract addresses","url":"https://docs.arc.io/arc/references/contract-addresses"},{"title":"Circle Docs: Circle Gateway","url":"https://developers.circle.com/gateway"}],"paths":{"/v1/lookup":{"get":{"operationId":"lookupOwnerlessBridgeArcus","summary":"Look up any Arc or Base token’s ownerless CTS bridge","tags":["Blockchain data"],"x-keywords":["blockchain","bridge","cross-chain","tokens","arc","base","circle","cts"],"x-payment-option":{"rail":"arcus","priceUSDC":"0.007","enabled":true},"x-payment-networks":["eip155:5042"],"description":"Argos Bot CTS Bridge Lookup\nLook up any Arc or Base token’s ownerless bridge using Circle’s Crosschain Token Standard (CTS), CrossChainTokenService and CCTP. Get original and wrapped token addresses, wrapped supply, contracts and verification status.\nGET https://arcus-api.argosbot.io/v1/lookup?token=0x...&chain=arc|base\nInputs and responses match the Argos Bot CTS Bridge Lookup CRA service.\nOptional finality=latest|finalized. Supply chain when an address is ambiguous.\nLookup only: no wallet transactions, registration, wrapper creation or bridge execution.\nPrice: 0.007 USDC per lookup, paid on Arc through Arcus x402 v2 exact settlement.\nThe chain parameter selects the token chain, not the payment network.\nA missing bridge or failed contract verification is a valid paid result. Dependency failures are not settled.\nKeep the original Payment-Signature and identical query for recovery. Never pay again after uncertain settlement.\nUncertain Arcus settlements require reconciliation; the API never automatically resubmits them.\nVerification is not certification of token transfer behavior, liquidity or redemption safety.\nOpenAPI: https://arcus-api.argosbot.io/openapi.json\nMCP: POST https://arcus-api.argosbot.io/mcp (stateless Streamable HTTP, protocol 2025-06-18).\nMCP clients must send Accept: application/json, text/event-stream and Content-Type: application/json.\nInitialize, tools/list and resources/list/read are free. The lookup_ownerless_bridge tool takes token, optional chain and finality.\nAn unpaid tool call returns an x402 PaymentRequired object in structuredContent and content[0].text with isError=true.\nAn x402-capable MCP client retries with the payment payload in params._meta[\"x402/payment\"].\nSettlement receipts appear in result._meta[\"x402/payment-response\"]. HTTP Payment-Signature is for REST only.\nKeep identical tool arguments and the SAME payment payload for recovery; errors do not imply payment was unspent.\nMCP uses the same payment journal and purchase scope as REST. A generic MCP client without x402 support can discover tools but cannot purchase a lookup.\nIdentity: Arc ERC-8004 agent 304; registration metadata: https://arcus-api.argosbot.io/.well-known/agent-registration.json\nNo reputation or validation trust mechanism is claimed. Registration and contract checks are not a safety endorsement.\nHealth: /health reports configuration only, not live RPC or facilitator availability.\n","parameters":[{"name":"token","in":"query","required":true,"description":"Original or wrapped ERC-20 contract address to check. Replace the example with any Arc or Base token address.","schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"example":"0xece5ca8bf9220718e5727754026757512212cb3c"},{"name":"chain","in":"query","required":false,"description":"Chain containing the input address; omit to inspect both Arc and Base.","schema":{"type":"string","enum":["arc","base","5042","8453"]},"example":"arc"},{"name":"finality","in":"query","required":false,"description":"Block finality used for the lookup.","schema":{"type":"string","enum":["latest","finalized"],"default":"latest"},"example":"latest"},{"name":"Payment-Signature","in":"header","schema":{"type":"string"},"description":"Base64 x402 v2 payment payload, obtained by handling the 402 challenge. Keep private for response recovery."}],"responses":{"200":{"description":"Successful lookup or recovered paid result. No-registration, incomplete-setup and verification-failed findings are valid lookup results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupResponse"}}}},"400":{"description":"Invalid input; not charged"},"402":{"description":"x402 payment required or invalid payment authorization"},"409":{"description":"Existing payment pending, conflicting, expired or not charged; inspect state before retrying"},"429":{"description":"Rate limit; Retry-After supplied"},"503":{"description":"Disabled or dependency unavailable. If a requestId is present, settlement may require reconciliation; do not create a second authorization."}}}}},"components":{"schemas":{"Token":{"type":"object","required":["address","chainId","chain","role","isBridgedRepresentation"],"properties":{"address":{"type":"string"},"chainId":{"type":"integer","enum":[5042,8453]},"chain":{"type":"string","enum":["Arc","Base"]},"role":{"type":"string","enum":["original","wrapped"]},"isBridgedRepresentation":{"type":"boolean"},"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"explorerUrl":{"type":"string"}}},"Candidate":{"type":"object","properties":{"status":{"type":"string","enum":["not_a_contract","not_registered","wrapper_missing","verified","verification_failed","unavailable"]},"connectionExists":{"type":["boolean","null"]},"ownerlessVerified":{"type":["boolean","null"]},"source":{"$ref":"#/components/schemas/Token"},"destination":{"anyOf":[{"$ref":"#/components/schemas/Token"},{"type":"null"}]},"original":{"$ref":"#/components/schemas/Token"},"wrapped":{"anyOf":[{"$ref":"#/components/schemas/Token"},{"type":"null"}]},"direction":{"type":"string"},"operation":{"enum":["lock_and_mint","burn_and_unlock"]},"wrappedSupply":{"type":["object","null"],"properties":{"raw":{"type":"string"},"formatted":{"type":"string"},"chainId":{"type":"integer"},"tokenAddress":{"type":"string"},"decimals":{"type":"integer"},"meaning":{"type":"string"}}},"evidence":{"type":"array","items":{"type":"object"}},"contracts":{"type":"array","items":{"type":"object"}},"operational":{"type":"object"},"error":{"type":"string"}}},"LookupResponse":{"type":"object","required":["requestId","result","payment"],"properties":{"requestId":{"type":"string"},"payment":{"type":"object","description":"Facilitator settlement acknowledgement; Gateway batching is not necessarily a final onchain transfer."},"result":{"type":"object","properties":{"status":{"enum":["complete","ambiguous","unavailable"]},"observedAt":{"type":"string","format":"date-time"},"cached":{"type":"boolean"},"cacheAgeMs":{"type":"integer"},"candidates":{"type":"array","items":{"$ref":"#/components/schemas/Candidate"}}}}}}}}}