What the EZManager SDK is
EZManager SDK is a multi-language developer toolkit for opening, managing, valuing, and exiting EZManager positions across supported chains.
It includes standard JavaScript and Python SDKs for direct integration, plus a Python strategy workflow for users who want to generate or run automated position-management scripts from plain-language instructions.
Choose your path
| Path | Use it when | What you get |
|---|---|---|
| python/ | You want automation, strategy scripts, or a Python SDK. | Examples, strategy files, and everything needed to run automated workflows. |
| js/ | You want a JavaScript SDK for scripts or backend integrations. | Node.js examples for the main lifecycle and read flows. |
Common use cases
| Use case | Recommended path | What to do |
|---|---|---|
| I want an AI agent to create and run EZManager automation for me. | Python strategy harness | Work from the python folder, generate a strategy file, add your position key, and run it with EXECUTE = False first. |
| I want a conventional SDK for scripts or backend jobs. | JavaScript or Python SDK | Choose one language folder, set your environment variables, and start from the examples. |
| I want to dry-run logic before letting it trade. | Python strategy harness with EXECUTE = False | Leave EXECUTE = False until the planned actions look correct, then switch it to True for live execution. |
How to get started
- Clone the EZManagerSDK repo and choose the python folder for automation or the js folder for JavaScript integration.
- Copy .env.example to .env and set RPC_URL plus PRIVATE_KEY.
- Point RPC_URL to the chain you want to use. The example scripts then run on that chain automatically.
- Start with the provided examples, or create a Python strategy file if you want automated position management.
Supported chains
| Chain | Chain ID | How to use it |
|---|---|---|
| Ethereum Mainnet | 1 | Set RPC_URL to an Ethereum mainnet RPC endpoint. |
| Base | 8453 | Set RPC_URL to a Base RPC endpoint. |
| Arbitrum | 42161 | Set RPC_URL to an Arbitrum RPC endpoint. |
| BNB Chain | 56 | Set RPC_URL to a BNB Chain RPC endpoint. |
| HyperEVM | 999 | Set RPC_URL to a HyperEVM RPC endpoint. |
How users switch chains
Users switch chains by changing RPC_URL to an endpoint for the chain they want to use.
Once RPC_URL points to the right network, the example scripts and SDK calls use that chain automatically.
Python automation workflow
The Python workflow is built for users who want automated position management. You create or generate a strategy file, set your position key and thresholds, review the planned behavior, and then allow live execution when ready.
This makes it practical to describe a strategy in plain English, generate a runnable script, and keep the actual interaction flow simple: configure, preview, then execute.