Skip to main content
Every call to our services must include the sign parameter. sign is generated from the parameters you send plus your API key.

Which parameters to include

  • Include only the fields marked Signed in each API’s parameter list. Unmarked fields and sign itself are not included.
  • Include a Signed field even when it has no value. For example, on the first query nextToken is an empty string and is included as nextToken=.
  • Use the exact string you send as the value. For example, if you send amount as 10.00, sign 10.00, not 10.
  • Array parameters repeat the same key, in the order they are sent, for example gameIDList=102&gameIDList=101.

Steps

  1. Sort by key: Sort parameter names by character code (ASCII), so uppercase letters come before lowercase letters.
  2. URL-encode into a query string: Encode both keys and values, join each pair with = and the pairs with &. Encoding rules:
    • Letters, digits and -, _, ., ~ are not encoded.
    • A space becomes +.
    • Every other character is UTF-8 encoded as %XX with uppercase hex, for example : becomes %3A and + becomes %2B.
  3. Append the API key and hash with MD5: Append your API key directly to the query string with nothing in between. The MD5 of the result, as a lowercase 32-character hex string, is sign.
A time value such as 2025-12-01T00:00:00.000+08:00 is encoded as 2025-12-01T00%3A00%3A00.000%2B08%3A00.

Example

For Deposit with the API key a188va:

Code examples

Each example below has been run with the sample data above and returns 4899d19dd28e49b04e1656afb1f7dc4f.

Troubleshooting

If the response code is 102 (Sign invalid), check the following in order:
  1. You included exactly the fields marked Signed, no more and no fewer.
  2. The values you signed are identical to the values you sent, including decimal places and letter case.
  3. Percent-encoding uses uppercase hex, spaces become + (not %20), and ~ is left unencoded.
  4. The MD5 result is lowercase.
  5. The API key is correct and has no leading or trailing spaces or line breaks.