2. Single Market Listing Query

Request Parameters

Response Fields

data.products[] returns name, assetid, icon_url, unit_price, currency, trade_id, market_hash_name, delivery_type, exterior_wear, paint_index, and paint_seed. unit_price is returned in the channel account settlement currency, and currency is CNY or USD. delivery_type values are 1 auto delivery, 2 manual delivery, and 3 fast manual delivery. The local view uses request pagination: data.page.page_no is the current page and data.page.is_more is the number 1 when another page is available, or 0 otherwise. Other query modes return all matching products together with page_no=1 and is_more=0.

Product Fields (products[])

These product field definitions apply to single and batch listing queries, full product sync, and WSS product data. Batch queries have no pagination object; full sync pagination is defined in its own section.

{
  "paint_index": 415,
  "is_doppler": true,
  "family": "DOPPLER",
  "style": "RUBY",
  "label": "红宝石"
}

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "products": [
      {
        "name": "★ Bayonet | Blue Steel (Factory New)",
        "assetid": "52375307516",
        "icon_url": null,
        "unit_price": "2769.11",
        "currency": "CNY",
        "trade_id": 4367083724629687919,
        "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
        "delivery_type": 1,
        "exterior_wear": "0.0484905764460563",
        "paint_index": 42,
        "paint_seed": 315
      },
      {
        "name": "★ Bayonet | Blue Steel (Factory New)",
        "assetid": "52880046415",
        "icon_url": null,
        "unit_price": "2794.39",
        "currency": "CNY",
        "trade_id": 1505071163657550713,
        "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
        "delivery_type": 2,
        "exterior_wear": "0.04713385552167892",
        "paint_index": 42,
        "paint_seed": 183
      },
      {
        "name": "★ Bayonet | Blue Steel (Factory New)",
        "assetid": "52827100695",
        "icon_url": null,
        "unit_price": "2831.47",
        "currency": "CNY",
        "trade_id": 5379122505345477793,
        "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
        "delivery_type": 3,
        "exterior_wear": "0.023534592241048813",
        "paint_index": 42,
        "paint_seed": 557
      }
    ],
    "page": {
      "page_no": 1,
      "is_more": 0
    }
  }
}

2.1 Single Listed Item Details

A successful query refreshes the inventory record and uses the existing WebSocket product change notification mechanism. Response and notification prices include the receiving channel's premium and use its settlement currency.

Submit as application/x-www-form-urlencoded. Common parameters partner_key, t and sign are required. Use the common signing rules and include trade_id in the signature.

The account must have access to the relevant product source. This endpoint always performs a live lookup, regardless of the local listing query setting. trade_id is the only business parameter required; app_id, market_hash_name and pagination parameters are unnecessary. An unavailable, missing or unsupported item returns code=201002, data=null and an error message. Query failures never return a stale local quote.

Response

Success returns code=1 and message=success. data is a single product object, using the same fields and null rules as the trade_list products[] field table, including conditional Doppler fields. There is no products, rows or page wrapper. unit_price includes account pricing and is denominated in the account settlement currency; currency is CNY or USD. delivery_type is 1 automatic, 2 manual, or 3 fast manual delivery, never null. A quote does not reserve inventory or guarantee the price at purchase time.

Request Example

curl -X POST 'https://www.maiyidun.com/third/distribution/api/trade_info' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'trade_id=4367083724629687919' \
  --data-urlencode 'partner_key=YOUR_PARTNER_KEY' \
  --data-urlencode 't=TIMESTAMP_IN_SECONDS' \
  --data-urlencode 'sign=SIGNATURE'

Success Example

{
  "code": 1,
  "message": "success",
  "data": {
    "name": "★ Bayonet | Blue Steel (Factory New)",
    "assetid": "52375307516",
    "icon_url": null,
    "unit_price": "2769.11",
    "currency": "CNY",
    "trade_id": 4367083724629687919,
    "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
    "delivery_type": 1,
    "exterior_wear": "0.0484905764460563",
    "paint_index": 42,
    "paint_seed": 315
  }
}

Unavailable Item Example

{"code":201002,"message":"商品已失效或不存在，请重新拉取列表","data":null}

Full Product Sync

This endpoint reads only the platform's local product database. It does not call a downstream platform API.

Request Parameters

Products are queried in ascending id order. The next request uses id > next_cursor. Continue while is_more=true. Product unit_price is returned in the channel account settlement currency, and the product-level currency field is returned as CNY or USD. Doppler extra fields are the same as trade_list. This endpoint uses the common RSA-SHA256 signature rules and form/urlencode submission.

Product fields in data.products[] match trade_list. delivery_type is an integer: 1 auto delivery, 2 manual delivery, or 3 fast manual delivery.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "products": [
      {
        "name": "Galil AR | Sage Spray (Field-Tested)",
        "assetid": "51835031209",
        "icon_url": null,
        "unit_price": "0.07",
        "currency": "CNY",
        "trade_id": 3802387914421840091,
        "market_hash_name": "Galil AR | Sage Spray (Field-Tested)",
        "delivery_type": 2,
        "exterior_wear": "0.3780631124973297",
        "paint_index": 119,
        "paint_seed": 517
      }
    ],
    "is_more": true,
    "next_cursor": "2085000000123"
  }
}

Full Sync Pagination Fields

Example Request

curl -X POST 'https://www.maiyidun.com/third/distribution/api/market_item_list' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'app_id=730' \
  --data-urlencode 'page_size=100' \
  --data-urlencode 'next_cursor=' \
  --data-urlencode 'partner_key=YOUR_PARTNER_KEY' \
  --data-urlencode 't=1770000000' \
  --data-urlencode 'sign=YOUR_SIGNATURE'

3. Batch Market Listing Query

The response field data.products[] uses the same structure as trade_list, including the product-level currency field.

Product delivery_type is an integer: 1 auto delivery, 2 manual delivery, or 3 fast manual delivery.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "products": [
      {
        "name": "★ Bayonet | Blue Steel (Factory New)",
        "assetid": "52375307516",
        "icon_url": null,
        "unit_price": "2769.11",
        "currency": "CNY",
        "trade_id": 4367083724629687919,
        "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
        "delivery_type": 1,
        "exterior_wear": "0.0484905764460563",
        "paint_index": 42,
        "paint_seed": 315
      },
      {
        "name": "★ Bayonet | Blue Steel (Factory New)",
        "assetid": "52880046415",
        "icon_url": null,
        "unit_price": "2794.39",
        "currency": "CNY",
        "trade_id": 1505071163657550713,
        "market_hash_name": "★ Bayonet | Blue Steel (Factory New)",
        "delivery_type": 2,
        "exterior_wear": "0.04713385552167892",
        "paint_index": 42,
        "paint_seed": 183
      }
    ]
  }
}

4. Buy Specific Item

If the request times out or returns no result, query get_order_by_channel_no after about 2 minutes to avoid duplicate orders.

Purchase Response Fields (data)

data contains channel_order_no, total_amount, currency, total_qty, order_number, and order_list[]. Each sub-order has order_id, amount, currency, and qty. Amount fields are returned in the channel account settlement currency.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "channel_order_no": "test1322",
    "total_amount": "0.03",
    "currency": "CNY",
    "total_qty": 1,
    "order_number": 123,
    "order_list": [
      {
        "order_id": 21146389,
        "amount": "0.03",
        "currency": "CNY",
        "qty": 1
      }
    ]
  }
}

4.1 Quick Order by Conditions

The common authentication fields partner_key, t and sign are required. Sign all supplied business parameters, including optional wear parameters, using the common signature rules.

Do not send trade_id or unit_price. Each request purchases one item. max_price is a cap, not the charged amount. The cap is held after submission; a successful purchase charges the actual platform selling price and releases any unused held amount, never exceeding max_price. USD orders use the exchange rate captured at submission; responses and subsequent queries use stored amounts.

No matching item, insufficient maximum price or balance, or an unavailable purchase mode returns a failure. For a timeout or unconfirmed result, query get_order_by_channel_no with the original channel_order_no after two minutes; do not purchase again. Existing query, cancellation, history and callback APIs apply.

curl -X POST 'https://www.maiyidun.com/third/distribution/api/quick_order' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'channel_order_no=condition-demo-001' \
  --data-urlencode 'market_hash_name=M4A1-S | Leaded Glass (Factory New)' \
  --data-urlencode 'max_price=10.00' \
  --data-urlencode 'exterior_wear_start=0' \
  --data-urlencode 'exterior_wear_end=0.07' \
  --data-urlencode 'fetch_track_link=https://steamcommunity.com/tradeoffer/new/?partner=123&token=EXAMPLE' \
  --data-urlencode 'fetch_steam_uid=76561198000000000' \
  --data-urlencode 'partner_key=YOUR_PARTNER_KEY' \
  --data-urlencode 't=TIMESTAMP_IN_SECONDS' \
  --data-urlencode 'sign=SIGNATURE'

Response fields and types match trade_buy. total_amount and order_list[].amount are actual charged amounts; currency is the account settlement currency. Success uses code=1; business errors return the corresponding 201xxx code and message, while authentication errors use the common 101xxx codes. Example: cap 10.00, actual charge 9.27:

{
  "code": 1,
  "message": "success",
  "data": {
    "channel_order_no": "condition-demo-001",
    "total_amount": "9.27",
    "currency": "USD",
    "total_qty": 1,
    "order_number": 123,
    "order_list": [{"order_id": 123, "amount": "9.27", "currency": "USD", "qty": 1}]
  }
}

5. Query Order Status

data.rows[] contains status, channel_order_no, fetch_steam_uid, withdrawn_flag, withdrawal_liability_status, order_id, provisional_time, qty, penalty_amount, amount, currency, create_time, cancel_type, trade_offer, original_amount, order_number, service_charge, and order_type. Amount fields are returned in the channel account settlement currency. For USD channels, the order's USD paid amount snapshot is returned.

withdrawn_flag: 0 normal, 1 withdrawn. withdrawal_liability_status: 0 none, 1 buyer, 2 seller, 3 no liability, 4 pending liability. Returned as null when not provided by the platform.

provisional_time: Time information related to the trade protection period. This query endpoint currently always returns null, meaning that this time information is not provided. It does not mean that the order has no protection period or that the period has ended. The specific meaning, format, and unit of a non-null value have not yet been defined. Do not use this field to determine whether the protection period has ended.

Order Detail Fields (data.rows[])

This endpoint can query only orders that belong to the current partner_key. Requests for other channels' orders return 订单无权限.

Order status definition: 0 settling, 1 cancelled, 2 waiting for seller delivery, 3 waiting for buyer receipt, 4 completed and settled, and 99 other. Internal platform status WITHDRAWN is returned externally as 1 cancelled. The platform returns 4 only when orderStatus=FINISHED and settleStatus=1.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "rows": [
      {
        "status": 1,
        "channel_order_no": "TEST-TRADE-8419155627264995664",
        "fetch_steam_uid": "76561198099332339",
        "withdrawn_flag": "0",
        "withdrawal_liability_status": "0",
        "order_id": 2077642587203555328,
        "provisional_time": null,
        "qty": 1,
        "penalty_amount": "0",
        "amount": "2.01",
        "currency": "CNY",
        "create_time": "2026-07-16 14:32:48",
        "cancel_type": 1,
        "trade_offer": null,
        "original_amount": "2.01",
        "order_number": 2077642587203555328,
        "service_charge": "0",
        "order_type": 1
      }
    ]
  }
}

Acceptance of a cancellation request does not mean the order is cancelled. Confirm final status through order queries or notifications. Supply channel_order_no if order_id is ambiguous; both identifiers must refer to the same order when supplied together.

6. Apply To Cancel Order

The endpoint path is fixed as apply_cancle_order. The final result must be confirmed by querying order status.

Returns the order detail structure. rows may be empty when only the application was accepted; query the final status separately.

Fields in data.rows[] have the same meanings as the order status query. code=1 does not guarantee status=1; use the returned order status to confirm cancellation.

This endpoint can cancel only orders that belong to the current partner_key. Requests for other channels' orders return 订单无权限.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "rows": [
      {
        "status": 4,
        "channel_order_no": "TEST-TRADE-5977148147654219206",
        "fetch_steam_uid": "76561198099332339",
        "withdrawn_flag": "0",
        "withdrawal_liability_status": "0",
        "order_id": 2079823602818842624,
        "provisional_time": null,
        "qty": 1,
        "penalty_amount": "0",
        "amount": "0.59",
        "currency": "CNY",
        "create_time": "2026-07-22 14:59:26",
        "cancel_type": 1,
        "trade_offer": null,
        "original_amount": "0.59",
        "order_number": 2079823602818842624,
        "service_charge": "0.00",
        "order_type": 1
      }
    ]
  }
}

7. Query Historical Orders

Status values are the same as the order status query. Internal platform withdrawn orders are returned externally as 1 cancelled, and only completed-and-settled orders are returned as 4.

data.rows[] contains amount, original amount, currency, Steam UID, withdrawal status, withdrawal liability status, created/end time, Unix timestamps, sub-order ID, penalty amount, cancellation reason, main order number, service charge, and order type. Amount fields are returned in the channel account settlement currency. For USD channels, the order's USD paid amount snapshot is returned. Pagination is returned in data.page.

Historical Order Field Differences And Pagination

History rows do not return qty, trade_offer, or provisional_time. Do not assume they contain every field from the order query response.

This endpoint returns only historical orders that belong to the current partner_key.

Response Example

{
  "code": 1,
  "message": "success",
  "data": {
    "rows": [
      {
        "status": 4,
        "channel_order_no": "TEST-TRADE-1651620685707114623",
        "amount": "1.82",
        "original_amount": "1.82",
        "currency": "CNY",
        "fetch_steam_uid": "76561198099332339",
        "withdrawn_flag": "0",
        "withdrawal_liability_status": "0",
        "created": "2026-07-18 23:21:17",
        "end_time": "2026-07-19 11:11:24",
        "created_timestamp": "1784388077",
        "end_time_timestamp": "1784430684",
        "order_id": 2078500345364721664,
        "penalty_amount": "0",
        "cancel_type": null,
        "order_number": 2078500345364721664,
        "service_charge": "0.00",
        "order_type": 1
      }
    ],
    "page": {
      "page_no": 1,
      "is_more": false
    }
  }
}

8. Merchant Info Query

Merchant Fields (data[])

This endpoint only requires the common authentication parameters. Balance and locked balance are returned in the channel account settlement currency, and the account object includes a currency field.

Response Example

{
  "code": 1,
  "message": "success",
  "data": [
    {
      "username": "Channel A",
      "lock_cash": "0.00",
      "balance": "27.57",
      "currency": "CNY"
    }
  ]
}