Create Order

Create resource order

Create order

POSThttps://api.mefree.net/api/order

Query parameters

Header parameters

Response

200

OK

Body

*/*

codeinteger (int32)

0 indicates success; non-zero values indicate errors.

msgstring

error message

sub_codestring

sub_msgstring

dataAPIDelegateResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.mefree.net/api/order?target_address=text&period=0', {
    method: 'POST',
    headers: {
      "MF-ACCESS-KEY": "text",
      "MF-ACCESS-TIMESTAMP": "text",
      "MF-ACCESS-SIGN": "text"
    },
});
const data = await response.json();

Response

200

{
  "code": 0,
  "msg": "text",
  "sub_code": "text",
  "sub_msg": "text",
  "data": {
    "pay_hash": "text",
    "timestamp": 0,
    "pay_address": "text",
    "delegate_hash": "text",
    "amount_sun": 0,
    "energy_to_address": "text",
    "energy_quantity": 0,
    "energy_period": 0,
    "energy_expired_timestamp": 0,
    "status": "TRANSFER_SUCCESS",
    "confirm_status": "UNCONFIRMED",
    "activate_status": "DEACTIVATE",
    "balance": 0
  }
}

Core API: Create Order (POST /order)

When creating an order through Mefree.net's API, it is crucial to track the following three return values:

1. pay_hash (Payment Hash / Order ID):

   • This is a unique identifier for the order.

   • Use it to query the order details via the GET /order/{pay_hash} endpoint.

2. status (Order Status):

   • Indicates the progress of the order.

   • When the status is DELEGATE_SUCCESS, it means the energy transaction has been successfully submitted to the TRON blockchain.

   • Note: A very small chance (~0.1%) exists where the transaction may not be added to the chain.

3. confirm_status (On-chain Confirmation Status):

   • Confirms whether the energy has been successfully transferred on-chain.

   • When confirm_status is DELEGATION_CONFIRMED, it guarantees that the energy has been delivered to the target address.

---

Q: How to ensure that energy is sent to the address?

There are two ways to verify successful energy delivery:

1. Query the energy balance of the address via the TRON API:

   • Use TRON's official API or a TRON wallet (e.g., TronLink) to check the target address's current energy balance.

   • Endpoint Example (TRON Grid API):

     curl --request POST \
          --url https://api.trongrid.io/wallet/getaccountresource \
          --header 'accept: application/json' \
          --header 'content-type: application/json' \
          --data '
     {
       "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
       "visible": true
     }
     '

     Parse the response to check the energy_limit or energy_used field.

2. Check the confirm_status of the order:

   • Use the GET /order/{pay_hash} endpoint to retrieve the order details.

   • If confirm_status is DELEGATION_CONFIRMED, the energy transaction has been confirmed on the blockchain, and the target address has received the energy.

---

Example Workflow

1. Create an Order

Request:

POST /order?quantity=65000&target_address=TRON_ADDRESS&period=1
Host: https://api.mefree.net
Headers: 
  Content-Type: application/json
  MF-ACCESS-KEY: {api_key}
  MF-ACCESS-SIGN: {signature}
  MF-ACCESS-TIMESTAMP: {timestamp}

Response:

{
  "pay_hash": "abcd1234",
  "status": "DELEGATE_SUCCESS",
  "confirm_status": "UNCONFIRMED"
}

2. Query Order Details

Request:

GET /order/abcd1234
Host: https://api.mefree.net
Headers: 
  Content-Type: application/json
  MF-ACCESS-KEY: {api_key}
  MF-ACCESS-SIGN: {signature}
  MF-ACCESS-TIMESTAMP: {timestamp}

Response:

{
  "pay_hash": "abcd1234",
  "status": "DELEGATE_SUCCESS",
  "confirm_status": "DELEGATION_CONFIRMED"
}

3. Verify Energy Delivery

• If confirm_status = DELEGATION_CONFIRMED, the energy has been delivered.

• Alternatively, check the energy balance of the receiver address via TRON’s blockchain API.

---

By combining order tracking (pay_hash and confirm_status) and on-chain verification, you can ensure that energy transactions are reliable and properly executed. If any issues arise, contact Mefree support(@mefreenet) for assistance.