{"uid":"cap_yP7itWgy0koewVscChdz8","slug":"zerion-api-update-transaction-subscription-chain-ids-39b0bbba","name":"Zerion API - Update Transaction Subscription Chain IDs","description":"Interpreted wallet data for more than 40 chains and Solana: portfolios, DeFi positions, PnL, transactions and NFTs. REST for apps, x402 pay-per-call for agents.","url":"https://api.zerion.io/v1/tx-subscriptions/%7Bsubscription_id%7D/chain_ids?utm_source=zero.xyz","method":"PATCH","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["subscription_id","chain_ids"],"properties":{"chain_ids":{"type":"array","items":{"type":"string"},"description":"Full replacement set of chain IDs"},"subscription_id":{"type":"string","description":"Subscription ID"}}},"type":{"type":"string","const":"http"},"method":{"enum":["PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kDW_4K84H_QUznX3Hij5D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates (patches) the list of chain IDs monitored by an existing transaction subscription","exampleAgentPrompt":"Update my Zerion transaction subscription (ID: sub_abc123) to monitor only Ethereum, Polygon, and Arbitrum — remove all other chains from the watchlist.","exampleUseCases":[{"title":"Narrow subscription to fewer chains","prompt":"I have a Zerion tx subscription with ID sub_xyz789 that's currently tracking too many chains — update it to only watch Ethereum mainnet and Base going forward."},{"title":"Expand monitoring to new L2","prompt":"My Zerion transaction subscription sub_456def needs to be updated to also include Optimism and zkSync Era in its chain IDs list."},{"title":"Reset chain list for a DeFi agent","prompt":"My DeFi agent's transaction subscription on Zerion has stale chain settings — patch subscription sub_789ghi to monitor only Solana and Avalanche."}],"resultDescription":"Returns the updated transaction subscription object with the new chain_ids configuration applied, confirming which chains are now being monitored by the subscription.","failureModes":["Invalid subscription_id returns 404 not found","Unrecognized chain_id values return 400 bad request","Attempting to set an empty chain_ids array may return a validation error","Expired or cancelled subscription may return 404 or 410 gone","Payment failure (insufficient USDC) blocks the request with a 402 response","Malformed PATCH body returns 422 unprocessable entity"],"whenToPreferThis":"Use this endpoint when you need to dynamically reconfigure which blockchains an existing Zerion transaction subscription monitors — for example, when a user adds a new chain to their portfolio or wants to reduce noise by narrowing the watched networks. This is the right call when the subscription already exists and only the chain filter needs updating, not when creating a new subscription from scratch.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T12:42:47.412Z","isFirstParty":false,"canonicalSlug":"zerion-api-update-transaction-subscription-chain-ids-39b0bbba"}