# Zerion API - Update Transaction Subscription Chain IDs

> Zerion API - Update Transaction Subscription Chain IDs is a paid API for AI agents from api.zerion.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

Updates (patches) the list of chain IDs monitored by an existing transaction subscription

## Facts

- Endpoint: PATCH https://api.zerion.io/v1/tx-subscriptions/%7Bsubscription_id%7D/chain_ids?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zerion-api-update-transaction-subscription-chain-ids-39b0bbba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yP7itWgy0koewVscChdz8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zerion-api-update-transaction-subscription-chain-ids-39b0bbba -d '<json body>'
```

Example prompt: Update my Zerion transaction subscription (ID: sub_abc123) to monitor only Ethereum, Polygon, and Arbitrum — remove all other chains from the watchlist.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

Returns the updated transaction subscription object with the new chain_ids configuration applied, confirming which chains are now being monitored by the subscription.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zerion-api-update-transaction-subscription-chain-ids-39b0bbba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zerion.io](https://www.zero.xyz/host/api.zerion.io/llms.txt)