Node proxy

Early access. The node proxy is not generally available yet; contact support for access. These management endpoints work today. Read the Node proxy guide first.

Get settings

Returns your broadcast policy.

GET/api/node_proxy/portal/settings

curl "https://apiv2.tronergy.io/api/node_proxy/portal/settings" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/settings", {
  method: "GET",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://apiv2.tronergy.io/api/node_proxy/portal/settings",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
)
data = response.json()

Response

{ "ok": true, "settings": { "allowInsufficientTrx": false, "broadcastFailBehavior": "protect" } }

Update settings

Changes your broadcast policy. Fields you leave out keep their value. Dashboard session only.

Portal session only — API keys get 403 SESSION_REQUIRED.

PUT/api/node_proxy/portal/settings

curl -X PUT "https://apiv2.tronergy.io/api/node_proxy/portal/settings" \
  -H "Cookie: <portal-session-cookie>" \
  -H "Content-Type: application/json" \
  -d '{
    "broadcastFailBehavior": "reject"
  }'

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/settings", {
  method: "PUT",
  headers: {
    Cookie: "<portal-session-cookie>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    broadcastFailBehavior: "reject",
  }),
});

const data = await response.json();

import requests

response = requests.put(
    "https://apiv2.tronergy.io/api/node_proxy/portal/settings",
    headers={
        "Cookie": "<portal-session-cookie>",
    },
    json={
        "broadcastFailBehavior": "reject",
    },
)
data = response.json()

Parameters

broadcastFailBehavior"protect" | "passthrough" | "reject"

What happens to a linked wallet's transaction when sponsorship fails: protect (default), passthrough or reject. Node links always use protect.

allowInsufficientTrxboolean

Reserved. Has no effect yet. Default false.

Response

{ "ok": true, "settings": { "allowInsufficientTrx": false, "broadcastFailBehavior": "reject" } }

List broadcast attempts

Broadcasts the proxy sponsored for you or held back, newest first.

GET/api/node_proxy/portal/attempts

curl "https://apiv2.tronergy.io/api/node_proxy/portal/attempts?page=1&pageSize=20" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/attempts?page=1&pageSize=20", {
  method: "GET",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://apiv2.tronergy.io/api/node_proxy/portal/attempts",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
    params={
        "page": 1,
        "pageSize": 20,
    },
)
data = response.json()

Parameters

pagenumberquery

Page number. Defaults to 1.

pageSizenumberquery

Items per page. Default 20, max 100.

senderstringquery

Filter by exact sender address.

Response

{
  "ok": true,
  "items": [
    {
      "txid": "9a3c...",
      "route": "gasless",
      "status": "submitted",
      "sender": "TSender...",
      "contractType": "TriggerSmartContract",
      "linkId": null,
      "operationId": "8d0f...",
      "submittedAt": "2026-10-21T10:01:00.000Z"
    }
  ],
  "pagination": { "page": 1, "pageSize": 20, "total": 1, "totalPages": 1 }
}

status: submitted (sent to the network) or protected (not broadcast).
route: gasless (sponsored), passthrough (sent unsponsored) or protect (held back).
operationId is the relay operation for a sponsored broadcast.

List node links

Returns your links, newest first, without paging. Codes are never listed.

GET/api/node_proxy/portal/links

curl "https://apiv2.tronergy.io/api/node_proxy/portal/links" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/links", {
  method: "GET",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.get(
    "https://apiv2.tronergy.io/api/node_proxy/portal/links",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
)
data = response.json()

Response

{
  "ok": true,
  "items": [
    { "id": "4b2e...", "label": "Mobile app", "status": "active", "expiresAt": "2027-01-19T10:00:00.000Z", "revokedAt": null, "createdAt": "2026-10-21T10:00:00.000Z" }
  ]
}

status is active, revoked or expired.

Create a node link

Creates a link and returns its code once. Dashboard session only, because a link code spends your balance. Up to 50 active links.

Portal session only — API keys get 403 SESSION_REQUIRED.

POST/api/node_proxy/portal/links

curl -X POST "https://apiv2.tronergy.io/api/node_proxy/portal/links" \
  -H "Cookie: <portal-session-cookie>" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Mobile app",
    "expiresInDays": 90
  }'

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/links", {
  method: "POST",
  headers: {
    Cookie: "<portal-session-cookie>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    label: "Mobile app",
    expiresInDays: 90,
  }),
});

const data = await response.json();

import requests

response = requests.post(
    "https://apiv2.tronergy.io/api/node_proxy/portal/links",
    headers={
        "Cookie": "<portal-session-cookie>",
    },
    json={
        "label": "Mobile app",
        "expiresInDays": 90,
    },
)
data = response.json()

Parameters

labelstring

Up to 120 characters.

expiresInDaysnumber | null

1-365. Default 30. null means it never expires; revoking is the only way to stop it.

Response (201)

{
  "ok": true,
  "link": { "id": "4b2e...", "code": "Zk3...", "label": "Mobile app", "status": "active", "expiresAt": "2027-01-19T10:00:00.000Z", "createdAt": "2026-10-21T10:00:00.000Z" }
}

code works like a password: anyone with it can spend your balance through the proxy. Store it safely.

Errors: 422 with code: "LINK_LIMIT_REACHED" (50 active links), 422 Validation failed, 403 SESSION_REQUIRED. On 503, list your links before trying again so you do not create two.

Revoke a node link

The link stops working almost at once. No body.

POST/api/node_proxy/portal/links/:id/revoke

curl -X POST "https://apiv2.tronergy.io/api/node_proxy/portal/links/4b2e6a1c-3d5f-4e7a-9b8c-1d2e3f4a5b6c/revoke" \
  -H "x-api-key: $TRONERGY_API_KEY"

const response = await fetch("https://apiv2.tronergy.io/api/node_proxy/portal/links/4b2e6a1c-3d5f-4e7a-9b8c-1d2e3f4a5b6c/revoke", {
  method: "POST",
  headers: {
    "x-api-key": process.env.TRONERGY_API_KEY,
  },
});

const data = await response.json();

import os
import requests

response = requests.post(
    "https://apiv2.tronergy.io/api/node_proxy/portal/links/4b2e6a1c-3d5f-4e7a-9b8c-1d2e3f4a5b6c/revoke",
    headers={
        "x-api-key": os.environ["TRONERGY_API_KEY"],
    },
)
data = response.json()

Parameters

idstringrequiredpath

Link ID.

Response

{ "ok": true }

An unknown or already revoked link returns 404 Not found.

Node proxy

Get settingsCopy Anchor Link

Update settingsCopy Anchor Link

List broadcast attemptsCopy Anchor Link

List node linksCopy Anchor Link

Create a node linkCopy Anchor Link

Revoke a node linkCopy Anchor Link

On this page

Get settings

Update settings

List broadcast attempts

List node links

Create a node link

Revoke a node link