Payful Query Skill#

This skill queries Payful account information via the Payful API.

Security notice: PAYFUL_TOKEN and PAYFUL_USER_ID are sensitive browser session cookies extracted from global.payful.com. They grant full access to your Payful account. Only set these values in a trusted environment and never share them.

Prerequisites#

Set the following environment variables:

• PAYFUL_TOKEN - Authentication token (from BF-INTERNATIONAL-MEMBER-TOKEN cookie)
• PAYFUL_USER_ID - User ID (from AGL_USER_ID cookie)

Usage#

Query Account Balance#

python

python scripts/query_balance.py

Query with Custom API URL#

If using a different Payful environment:

python

python scripts/query_balance.py --api-url https://other.payful.com

API Reference#

The skill uses the following Payful API endpoints:

Get Account Balance#

• URL: https://global.payful.com/api/user/account/queryUserAccBalByHomePage

• Method: GET

• Headers:

  • Accept: application/json, text/plain, */*
  • Accept-Language: zh-CN
  • request-system-name: member-exchange-client
  • Cookie: Contains authentication tokens

Response Format#

json

{
  "code": "0000",
  "data": {
    "totalBalance": "1234.56",
    "currency": "USD",
    "availableBalance": "1200.00",
    "frozenBalance": "34.56"
  },
  "message": "success"
}