[codex] add websocket billing callouts

[0xmts]

Summary

Adds measured billing and usage guidance to the core WebSocket guidance docs so builders see bandwidth-based subscription pricing and the right guardrails before they choose a broad stream.

What Changed

• added a targeted billing/risk warning to the Subscription API overview
• added a short pricing warning to the subscription endpoint index page
• added guidance to keep subscription scope narrow in the WebSocket best-practices doc
• expanded the general Alchemy best-practices page with WebSocket-specific usage guidance

Why

The docs already recommend using WebSockets for subscriptions only, but they did not clearly connect broad subscription scope to bandwidth-based billing or point users to spend caps and alerts where they make the transport choice.

Validation

• pnpm run lint:eslint content/api-reference/websockets/subscription-api.mdx content/api-reference/websockets/subscription-api-endpoints/subscription-api-endpoints.mdx content/api-reference/websockets/best-practices-for-using-websockets-in-web3.mdx content/tutorials/getting-started/developer-best-practices/best-practices-when-using-alchemy.mdx

[github-actions]

🔗 Preview Mode

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Apr 15, 2026, 6:51 PM

[github-actions]

🔍 Link Check

Status: ❌ Failed

Summary

Status	Count
🔍 Total	7895
✅ Successful	6758
⏳ Timeouts	0
🔀 Redirected	396
👻 Excluded	677
❓ Unknown	0
🚫 Errors	63
⛔ Unsupported	1

Broken links (63) — click to expand

Errors per input

Errors in ./content/wallets/pages/bundler-api/bundler-faqs.mdx

• [404] https://github.com/eth-infinitism/account-abstraction/blob/v0.8.0/erc/ERCS/erc-4337.md | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/changelog/2026-03-26.md

• [404] https://docs-lilac-beta.vercel.app/reference/tempo-api-quickstart | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/wallets/transactions/debug-transactions | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/tutorials/alchemy-university/smart-contract-basics/multi-sig-contracts.mdx

• [404] https://help.safe.global/en/articles/40869-what-is-safe | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/changelog/2026-04-09.md

• [404] https://jovay-release-registry.cn-hongkong.cr.aliyuncs.com/jovay/l2-rpc | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/api-reference/op-mainnet/op-mainnet-api-faq/op-mainnet-api-faq.mdx

• [403] https://goerlifaucet.com/ | Rejected status code: 403 Forbidden (configurable with "accept" option)

Errors in ./content/api-reference/starknet/starknet-api-faq.mdx

• [415] https://starkware.co/starknet/ | Rejected status code: 415 Unsupported Media Type (configurable with "accept" option)

Errors in ./content/api-reference/hyperevm/hyperevm-api-overview.mdx

• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-submit-work | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-gas-price | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-uncle-count-by-block-number | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-uncle-by-block-hash-and-index | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-estimate-gas | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-new-block-filter | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/web-3-sha-3 | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-max-priority-fee-per-gas | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-receipts-with-system-tx | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-filter-logs | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/net-listening | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-transaction-by-block-hash-and-index | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-transaction-count-by-number | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-code | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-system-txs-by-block-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-new-filter | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-transaction-count-by-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-block-number | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-storage-at | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-receipts | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-create-access-list | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-by-number | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-call-many | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-balance | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-transaction-by-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-chain-id | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-account-info | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-syncing | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-unsubscribe | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-blob-base-fee | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-filter-changes | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-transaction-count | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-call | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-uncle-count-by-block-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-using-big-blocks | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-logs | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/web-3-client-version | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-new-pending-transaction-filter | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-accounts | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-uncle-by-block-number-and-index | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-transaction-receipt | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-transaction-by-block-number-and-index | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-send-raw-transaction | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-account | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/net-version | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-raw-transaction-by-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-block-by-hash | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-uninstall-filter | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-subscribe | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-simulate-v-1 | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-fee-history | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-big-block-gas-price | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/hyperevm/hyper-evm-api-endpoints/eth-get-system-txs-by-block-number | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/api-reference/arbitrum/arbitrum-api-faq/arbitrum-api-faq.mdx

• [403] https://goerlifaucet.com/ | Error (cached)

Errors in ./content/api-reference/pricing-resources/resources/error-reference.mdx

• [415] https://docs.starkware.co/starkex/api/spot/error_codes.html | Rejected status code: 415 Unsupported Media Type (configurable with "accept" option)

Errors in ./content/api-reference/katana/katana-api-overview.mdx

• [404] https://docs-lilac-beta.vercel.app/docs/reference/katana-api-quickstart | Rejected status code: 404 Not Found (configurable with "accept" option)

View workflow run