---
title: "Paygo: exact fee quote for one token transfer"
method: POST
path: "/api/v1/paygo/estimate"
tags: ["Paygo"]
---

# Paygo: exact fee quote for one token transfer

`POST /api/v1/paygo/estimate`

## Request

- Base URL: `https://powersun.vip`
- URL: `https://powersun.vip/api/v1/paygo/estimate`
- Auth: API key in header `X-API-Key`

Partner API (wallet integrations). Returns an exact, fixed-price fee quote for a specific sender→recipient TRC-20 transfer, computed by live simulation on the TRON node (recipient storage state and the TIP-491 dynamic energy factor included). The quoted feeTrx is final: the user signs a TRX payment for exactly this amount. Requires a partner API key enabled for paygo.

## Request body

- object
  - `from` string, required: Sender TRON address (base58)
  - `to` string, required: Recipient TRON address (base58)
  - `tokenContract` string, required: TRC-20 contract address
  - `amount` string, required: Transfer amount in raw token units (USDT: 6 decimals)

## Response `200`

Fixed-price quote

- object
  - `estimateId` string
  - `energy` integer
  - `bandwidth` integer
  - `burnCostTrx` string
  - `feeTrx` string
  - `feeSun` integer: EXACT payment amount in SUN — build the TRX payment for precisely this integer value (do NOT derive it from feeTrx with float math; a 1-SUN mismatch is rejected with PAYMENT_MISMATCH)
  - `energyPriceSun` integer
  - `bandwidthPriceSun` integer
  - `payTo` string
  - `validUntil` string, date-time
  - `recipientInitialized` boolean

## Other responses

- `422`: Transfer would fail on-chain right now (insufficient balance, blacklist) — SIMULATION_FAILED

---

[API](https://skmtc.dev/powersun/apis/powersun-agent-api.md) · [All operations](https://skmtc.dev/powersun/apis/powersun-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/powersun/apis/powersun-agent-api/revisions/169cc1ebfd26?raw)