> For the complete documentation index, see [llms.txt](https://docs.tronsave.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tronsave.io/developers/code-examples.md).

# Code Examples

These pages contain complete, runnable scripts that walk through a full TronSave integration end to end — from building and signing a transaction to placing an order and confirming it was filled. Each example is self-contained: copy it, set your credentials, and run it.

The examples come in two flavors:

* **API Key** — authenticate with a TronSave API Key. Best for backend services that pay from a prepaid TronSave balance. See [Authentication](/developers/authentication.md).
* **Private Key** — sign and pay directly from a TRON account using its private key, no prepaid balance required.

{% hint style="info" %}
All examples use [TronWeb](https://tronweb.network/) `5.3.2`. Install it with:

```bash
npm i tronweb@5.3.2 @noble/secp256k1@1.7.1
```

Read more in the [TronWeb 5.3.2 release notes](https://tronweb.network/docu/docs/5.3.2/Release%20Note/).
{% endhint %}

{% hint style="warning" %}
Most examples reference the mainnet TronSave receiver address `TWZEhq5JuUVvGtutNgnRBATbF8BnHGyn4S`. When running against testnet (Nile), change it to `TATT1UzHRikft98bRFqApFTsaSw73ycfoS`. See [Environments & Networks](/developers/environments.md).
{% endhint %}

## v2 (current)

Use these examples for new integrations. They target the current TronSave API.

| **Example**                                                                                | **Auth**    | **Description**                                                             |
| ------------------------------------------------------------------------------------------ | ----------- | --------------------------------------------------------------------------- |
| [Buy Resources with an API Key](/developers/code-examples/buy-with-api-key.md)             | API Key     | Estimate cost and place a resource order paying from your TronSave balance. |
| [Buy Resources with a Private Key](/developers/code-examples/buy-with-private-key.md)      | Private Key | Sign and pay for a resource order directly from a TRON account.             |
| [Extend an Order with an API Key](/developers/code-examples/extend-with-api-key.md)        | API Key     | Extend an active delegation, paying from your TronSave balance.             |
| [Extend an Order with a Private Key](/developers/code-examples/extend-with-private-key.md) | Private Key | Extend an active delegation, signing and paying from a TRON account.        |

## v0 (legacy)

{% hint style="warning" %}
These are legacy v0 examples, kept for reference only. For new integrations use the v2 examples above.
{% endhint %}

| **Example**                                                                           | **Auth**    | **Description**                                                  |
| ------------------------------------------------------------------------------------- | ----------- | ---------------------------------------------------------------- |
| [Buy Energy with an API Key](/developers/code-examples/buy-with-api-key-1.md)         | API Key     | Legacy flow for buying Energy paying from your TronSave balance. |
| [Buy Energy with a Private Key](/developers/code-examples/buy-with-private-key-1.md)  | Private Key | Legacy flow for buying Energy signing from a TRON account.       |
| [Extend an Order with an API Key](/developers/code-examples/extend-with-api-key-1.md) | API Key     | Legacy flow for extending an active delegation with an API Key.  |

## Next steps

* [Quickstart](/developers/quickstart.md) — the shortest path to your first order.
* [API Reference](/developers/api-reference.md) — every endpoint these examples call.
* [SDK](/developers/sdk.md) (TypeScript, Rust, Python, Java, PHP) — a typed wrapper if you prefer not to call the HTTP API directly.