NAnano-gpt
Transactions

Verify a Polygon deposit and its credited balance

Changed on

Poll with the original account API key and complete URL-encoded txId. Unknown or foreign IDs return 404, not an inferred PENDING state. COMPLETED and balanceCredited true require a matching completed ledger deposit. EXPIRED means the acceptance window closed; it does not prove that no transfer was sent or rule out later reconciliation. Never resend solely because polling failed or the window expired.

get/transaction/status/polygon/{txId}

Request

  • Base URL
    https://nano-gpt.com/api
  • URL
    https://nano-gpt.com/api/transaction/status/polygon/{txId}
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Path parameters

txIdstring required

Complete opaque txId returned by create. Encode the entire value as one URL path segment.

Response

Current owner-scoped deposit state.

network'polygon'
tokenstring

POL for current native deposits.

chainId137
tokenDecimals18
addressstring

Receiving address; create a fresh payment window before every transfer despite address reuse.

jobIdstring
txIdstring

Opaque status identifier: address:jobId:expiry. Persist exactly and URL-encode when polling.

statusUrlstring

Relative URL to poll on https://nano-gpt.com with the same account API key.

status'PENDING' | 'CONFIRMING' | 'PROCESSING' | 'COMPLETED' | 'EXPIRED' | 'FAILED'
balanceCreditedboolean

True only when the status endpoint verifies a completed account-owned ledger deposit. Present in status responses.

creditedUsdnumber

Final credited USD when balanceCredited is true; prefer settlement.creditedUsdExact for exact accounting.

requestedUsdnumber

Original requested gross USD estimate.

quotedTokenAmountstring

Quoted POL quantity as a decimal string, not a guaranteed final USD credit.

quotedTokenAmountAtomicstring

Quoted POL quantity in atomic units (18 decimals). Parse as BigInt or another exact integer, never a floating-point Number.

quotedTokenUsdPricenumber

Indicative quote price, not a locked settlement price.

priceLockedfalse
expiresAtinteger

Payment-window expiry as Unix seconds. Do not send against expired or cancelled requests.

remainingTimeinteger

Seconds remaining when this response was built.

minimumDepositUsdnumber

Minimum requested gross USD estimate.

consolidationFeeUsdnumber
consolidationFeeUsdExactstring

Exact decimal string. Use decimal arithmetic.

estimatedCreditUsdnumber

Legacy estimate after conversion spread and consolidation fee, before bonus.

quotedEthAmountstring

Legacy alias for quotedTokenAmount on native POL.

quotedEthAmountWeistring

Legacy alias for quotedTokenAmountAtomic on native POL.

txHashstring
paidTokenAmountstring

Exact decimal string. Use decimal arithmetic.

paidTokenAmountAtomicstring

Changes