View Categories

Get Static Proxy Transaction Details

What this endpoint does

Use this endpoint to retrieve the details of a static proxy transaction by its order ID. It can help you verify a purchase or renewal and identify the nodes, amount, quantity, and service period associated with the transaction.

Endpoint

GET /openapi/static/trade/detail

Full URL:

https://{domain}/openapi/static/trade/detail

Include your user-id and access-key in the request headers.

Query parameters

ParameterRequiredDescription
trade_noYesThe order ID.

Example request:

GET /openapi/static/trade/detail?trade_no={trade-no} HTTP/1.1
Host: {domain}
client-id: {your-user-id}
access-key: {your-access-key}

Response fields

FieldDescription
trade_noThe order ID.
total_feeThe total transaction amount.
trade_timeThe time the order was created, returned as a Unix timestamp in seconds.
node_idsAn array containing the node IDs associated with the transaction.
node_qtyThe number of nodes in the transaction.
trade_modeThe transaction type: BUY for a purchase or EXTEND for a renewal.
wallet_paidThe amount deducted from the account balance.
period_daysThe purchase or renewal period in days.

This endpoint does not return a cashback_amount field.

Example response

{
  "code": 0,
  "msg": "Ok",
  "info": {
    "trade_no": "aB3cD5eF",
    "total_fee": "29.90",
    "trade_time": 1754064000,
    "node_ids": ["xK9mP2nQ", "yL0nR3sT"],
    "node_qty": 2,
    "trade_mode": "BUY",
    "wallet_paid": "29.90",
    "period_days": 30
  }
}

Frequently asked questions

Why does the API say that the order does not exist?

Make sure trade_no is complete and belongs to the account associated with your current API credentials. If the API continues to return 404 or order does not exist, save the order ID and response details, then contact QuarkIP Support.

How can I tell a purchase from a renewal?

Check trade_mode. A value of BUY indicates a purchase, while EXTEND indicates a renewal.