- Find your Trader Nodes, and delete the ones you no longer use.
- For each network, reuse a Global Node you already have, or deploy one.
- Replace the Trader Node endpoints in your application.
- Reinstall add-ons such as Warp transactions on the Global Node.
- Confirm the application works, then delete the Trader Node.
What changes when you move to a Global Node
A Global Node serves the same networks as a Trader Node and adds failover and routing to the nearest location. A few things work differently:
For a workload that must stay in one region, deploy a Dedicated Node instead.
Harmony isn’t available on Global Nodes. To keep a Harmony workload running, contact us about a Dedicated Node.
How to find your Trader Nodes
A Trader Node is a node whose endpoint host has the formnd-123-456-789.p2pify.com. Global Node endpoints use a per-network host that ends in core.chainstack.com. Dedicated Nodes also use nd-…p2pify.com hosts, and the deprecation doesn’t affect them.
With the Platform API or the Chainstack MCP server:
- Platform API — in List all nodes (v1), a Trader Node has
typeset tosharedandproviderset tochainstack_managedorvzo. Dedicated Nodes on the same providers havetypeset todedicated. - MCP server —
list_nodesreturnsnode_tier: "Trader"for each Trader Node.
Reuse a Global Node or deploy a new one
You need one Global Node per network, not one per Trader Node, because a Global Node is load-balanced and serves every region.- If you already have a Global Node on the same network, you can point the Trader Node’s traffic at it. If both nodes carry heavy traffic, deploy a separate Global Node for the Trader Node’s workload, so the move doesn’t add load to the existing node.
- If you don’t have a Global Node on that network, deploy one from the Nodes page and select Global Node as the node type. See Add a node to a network. A Global Node is ready in under a second.
What to do when you reach your plan’s node limit
Your plan’s node limit counts every node in your organization, including Trader Nodes, so a Global Node may not fit next to the Trader Node it replaces. The pricing page lists the limit for each plan. Migrate one network at a time to stay inside the limit:- Free one slot. Delete a Trader Node or Global Node that receives no requests, or move the clients of one Trader Node to another Trader Node on the same network and delete it.
- Deploy the Global Node for the first network, and update the endpoints for that network.
- Delete that network’s Trader Nodes. This frees at least one slot for the next network.
- Repeat for each network.
How to update the endpoint URLs
Copy each Global Node endpoint from the node’s Access and credentials on Chainstack, or fromhttps_endpoint and wss_endpoint in the Platform API. Don’t build the host from the network name: some hosts differ from it, for example polygon-mainnet.core.chainstack.com for Polygon and avalanche-fuji.core.chainstack.com for Avalanche Fuji Testnet.
If a Global Node you reuse shows Credential rotation in progress, copy the endpoints listed under New credentials. The old credentials stop working when the rotation is completed. See Rotate node credentials.
Most protocols put the auth token at the end of the URL:
On Avalanche, a Trader Node accepts the token before the chain path. A Global Node returns
404 for that URL, so move the token after the path when you switch.
Instead of the token, you can authenticate with the node’s username and password through HTTP basic authentication. See Authentication methods.
How to move add-ons
Add-ons don’t move with the endpoint. Install them on the Global Node from the node’s Add-ons tab.- Warp transactions — available on Global Nodes for Ethereum Mainnet, BNB Smart Chain Mainnet, and Solana Mainnet, on paid plans, with extra usage enabled. Warp transactions can’t run on the same node as MEV protection or optimized submission. MEV protection is on by default on a new Global Node for Ethereum and BNB Smart Chain, so disable it before you install Warp transactions.
- Unlimited Node and access rules — available on Global Nodes only.
How to finish the migration
You’re done with a network when your application runs on the Global Node and the Trader Node receives no requests.- Send a test request to each new endpoint, for example
eth_blockNumberon an EVM chain orgetSloton Solana. - Deploy the application change.
- On Node usage, confirm that the Trader Node’s requests stop.
- Delete the Trader Node. See Delete a node.
Migrate with an AI agent
An AI coding agent can run most of the migration with the Chainstack MCP server: inventory your nodes, deploy Global Nodes, update the endpoints in your code, and delete the Trader Nodes after you confirm. Two steps stay with you: installing add-ons and checking node usage, both on Chainstack. Set up the MCP server with your Chainstack API key, then paste this prompt into the agent in your project’s repository:Agent instructions
Migrate this project from Chainstack Trader Nodes to Global Nodes. Ask the user before every action that creates or deletes a node, and before you change code.- Inventory.
- Call
list_nodes. Trader Nodes havenode_tierset toTrader; group them bynetwork. - For each network, record any existing Global Node (
node_tierisGlobal). - Search the codebase and configuration files, including
.envfiles, for endpoints onp2pify.comhosts. Map each endpoint to its node by thend-ID in the host.
- Call
- Usage. Ask the user which Trader Nodes still receive traffic. They can see it on Chainstack under Node usage. Offer to delete the Trader Nodes that receive no requests and appear nowhere in the code.
- Plan.
- Show the user a table with one row per network: the Trader Nodes, the existing Global Node to reuse or a note to deploy one, and the files that reference each endpoint.
- Wait for approval.
- Migrate one network at a time. For each network:
- If the plan needs a new Global Node, call
get_deployment_optionsand pick the option withnode_tierGlobalfor thatnetwork. Then callcreate_nodewith itsblockchainandcloudIDs and the project ID fromlist_projects. - If
create_nodereturns an error that the maximum number of nodes is reached:- Stop and tell the user which network needs a slot.
- Offer to delete an unused node, or to move the clients of one Trader Node on the same network to another and delete it.
- Otherwise, point the user to support.
- Call
get_nodefor the Global Node, and build each URL from itshttps_endpointorwss_endpoint.- For a Global Node you reuse, ask the user whether it shows Credential rotation in progress on Chainstack. If it does, ask the user to put the URLs listed under New credentials into the project’s configuration files, and use those instead.
- For Avalanche, insert the chain path before the token, for example
/ext/bc/C/rpc/<token>. - For Aptos, keep the token before
/v1. - For the Ethereum and Gnosis Chain Beacon Chain API, use
/beacon/<token>.
- Replace the Trader Node endpoints in the code and configuration with the Global Node URLs. Show the diff.
- Send one read request through each new URL, such as
eth_blockNumber,getSlot, orgetblockcount, and report the result. - After the user deploys the change and confirms the Trader Node receives no requests, call
delete_nodefor that Trader Node.
- If the plan needs a new Global Node, call
- Add-ons. If a Trader Node ran Warp transactions, MEV protection, or optimized submission, tell the user to install the add-on on the Global Node from its Add-ons tab on Chainstack. For Warp transactions on Ethereum or BNB Smart Chain, disable MEV protection first.
- Harmony. If a Trader Node runs Harmony, don’t migrate it. Tell the user that Harmony isn’t available on Global Nodes, and point them to contact us about a Dedicated Node.
- Report. List each Trader Node, its replacement Global Node, the files changed, the test result, and any steps left for the user.