Onerway
POST

Account Detail Query

View as Markdown
Query account balances and transaction details for a specific currency.

Request

merchantNostringrequired
Merchant number assigned by Onerway. Retrieve it from the merchant portal or onboarding material after your sandbox or production account is created.
Example:801129
currencystringrequired
Currency to query.
Example:USD
beginTimestringrequired
Start time of the query window.
Example:2025-06-15 00:00:00
endTimestringrequired
End time of the query window.
Example:2025-09-10 12:12:12
sizeintegerrequired
Page size.
Example:10
currentintegerrequired
Current page number.
Example:1
txnTypestringoptional
Optional transaction-type filter.
signstringrequired
Request signature string. Generate it according to the Transfer request-signing rules with your merchant private key.

Request example

curl -X POST 'https://sandbox-api.onerway.com/payout/api/v1/acct/queryAcctDetail' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "beginTime": "2025-06-15 00:00:00",
  "currency": "USD",
  "current": 1,
  "endTime": "2025-09-10 12:12:12",
  "merchantNo": "801129",
  "sign": "{{SIGN}}",
  "size": 10
}'

Response

respCodestring
Response code returned by Onerway.
respMsgstring
Response message returned by Onerway.
Account detail and transaction ledger result.

Response example

{
  "respCode": "20000",
  "respMsg": null,
  "data": {
    "currency": "USD",
    "availBalance": "989734.42",
    "freezeBalance": "128.00",
    "accountTransactionDetails": [
      {
        "serviceId": "1965301543088029696",
        "txnType": "0107",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 989996.92,
        "moveAmount": -5,
        "accountBalanceAfter": 989991.92,
        "remark": "jiaoyiRemark",
        "balanceUpdDate": "2025-09-09 14:29:36"
      },
      {
        "serviceId": "1965301540898603008",
        "txnType": "0035",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 989997.98,
        "moveAmount": -1.06,
        "accountBalanceAfter": 989996.92,
        "remark": null,
        "balanceUpdDate": "2025-09-09 14:29:35"
      }
    ]
  }
}
No error responses are documented for this endpoint.

Account Currency Query

Query the currencies supported by the merchant account and their balances.

FX Rate Query

Query the indicative FX rate from a source currency to a target currency.