Query native TRX balance for any Tron wallet address via x402 micropayment.
What it does
This endpoint returns the native TRX balance for a given Tron wallet address. It is hosted by Erudite Intelligence LLC on their EruditePay x402 Bridge infrastructure, which supports 20 blockchains. The endpoint accepts a POST request with a JSON body containing an `address` field (a wallet or contract address) and returns a JSON object with a `success` boolean and a `data` object.
Payment is required per-call via the x402 protocol (HTTP 402 challenge). The endpoint accepts two payment options: USDC on Base (eip155:8453) at 10,000 base units ($0.01) or USDT on Tron (tron:728126428) at 10,000 base units ($0.01). Payments are facilitated through the EruditePay Bridge, with Coinbase CDP as one facilitator option. The provider is FinCEN MSB registered (BSA ID 31000324258137) and operates non-custodially.
Documentation beyond the landing page is sparse — the `/docs` path returns a 404, and the output schema example is a generic `{"success": true, "data": {}}` stub without specifying what fields appear in `data` for a balance query. Agents should expect a TRX balance value inside the `data` object but the exact structure is undocumented.
Capabilities
Use cases
- —Checking the native TRX balance of a Tron wallet before executing a transaction
- —Portfolio tracking tools that need real-time Tron balance data
- —Automated agents verifying wallet funding status on Tron
- —DeFi applications needing on-chain balance verification
Fit
Best for
- —AI agents needing programmatic Tron balance lookups with micropayment access
- —Applications already integrated with x402 payment protocol
- —Developers who want pay-per-call pricing without API key management
Not for
- —Bulk historical balance queries across thousands of addresses (no batch endpoint documented)
- —Free-tier or high-volume balance checking where $0.01/call adds up quickly
- —Querying non-native (TRC-20) token balances — this endpoint is specifically for native TRX
Quick start
curl -X POST https://bridge.eruditepay.com/v1/tron/wallet/native-balance \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"address": "TJYeasTPa8kNMgSJBKBP3d2jgSPwmGYnRG"}'Example
Request
{
"address": "TJYeasTPa8kNMgSJBKBP3d2jgSPwmGYnRG"
}Response
{
"data": {},
"success": true
}Endpoint
Quality
The endpoint is live (402 challenge captured) with a clear payment schema and input spec, but the output schema is a generic stub with no documented fields for the balance response. No dedicated docs page exists (/docs returns 404). The description 'Crypto data intelligence' is vague. Pricing is clear at $0.01/call.
Warnings
- —Output schema is a generic stub — actual response fields for balance data are undocumented
- —The /docs endpoint returns 404; no external documentation found
- —The example output {"success": true, "data": {}} does not show what balance fields are returned
- —TRC-20 token balance support is not indicated — endpoint name suggests native TRX only
Citations
- —Endpoint accepts USDC on Base (10,000 base units) and USDT on Tron (10,000 base units) as paymenthttps://bridge.eruditepay.com/v1/tron/wallet/native-balance
- —Provider is Erudite Intelligence LLC, FinCEN MSB registered with BSA ID 31000324258137https://bridge.eruditepay.com
- —EruditePay Bridge supports 20 blockchains and charges 0.5% per settlementhttps://bridge.eruditepay.com
- —The Bridge is non-custodial and implements x402 v2.0https://bridge.eruditepay.com
- —Input schema requires a JSON body with an 'address' field described as 'Wallet or contract address'https://bridge.eruditepay.com/v1/tron/wallet/native-balance