API

1. Submit a Ticket

• Path：/v4/{referrer}/ticket

• Method: POST

• Request param:

Parameter	isRequired	Type	Example	Description
referrer	true	string	0x06d96e...	referrer address, if you dont have one, can check here to add one.

• Request body:

Parameter	isRequired	Type	Example	Description
hash	false	string	0x06d96e...	transaction hash
question	false	string	question	question
account	true	string	0xddc0...	user's wallet address
quote	false	object	{}	quote info
transaction	false	object	{}	transaction info
error	false	object	{}	error info
chain	false	number	56	chain code
version	false	string	v2	quote v2/v4

• Request body example：

{
    "hash": "0x0b5a4b1ab8ca47a2a2dbf4e6a998b39f6d40caed14f0ac3f3faaef27c8959593",
    "chain": 56,
    "version": "v2",
    "question": "question",
    "account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
    "quote": {
      "quoteType": "swap",
      "inTokenSymbol": "BNB",
      "inTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "outTokenSymbol": "USDT",
      "outTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
      "amountAll": 1,
      "amount": 1000000000000000000,
      "gasPrice": 1100000000,
      "slippage": 100,
      "referrer": "0x3487ef9f9b36547e43268b8f0e2349a226c70b53",
      "disabledDexIds": ""
    },
    "transaction": {
        "from": "",
        "to": "",
        "value": "",
        "data": "",
        "gasPrice": "",
        "gasLimit": ""
    },
    "error": {
        "code": 400,
        "error": "no router"
    },
}

• Response：

Parameter	Type	Example	Description
ticket	string	5298615415	ticket code

• Response example：

{
    "code": 0,
    "msg": "ok",
    "data": {
        "ticket": "5298615415"
    }
}

2. Get the ticket list through referrer address

• Path：/v4/{referrer}/ticket

• Method: GET

• Request param:

Parameter	isRequired	Type	Example	Description
referrer	true	string	0x06d96e...	referrer address, if you dont have one, can check here to add one.

• Response：

Parameter	Type	Example	Description
hash	string	0x123c8...ce27	transaction hash
question	string	question	question
process	string	01	process
remark	string	ok	remark
answer	string	answer	answer
account	string	0xddc0...	user's wallet address
params	object	{}	params info
createAt	Date	2025-04-07T08:04:46.000Z	create time

• Response example：

{
    "code": 200,
    "data": [
            {
                "hash": "0xcaf525986a879ca5017ca9b934a402aa55232c5e983b245937d39a3583c2c49a",
                "remark": null,
                "process": "01",
                "question": "question",
                "answer": null,
                "params": {
                    "quote": {
                        "chain": "bsc",
                        "inTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
                        "outTokenAddress": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
                        "amount": 5,
                        "gasPrice": 1,
                        "slippage": 1,
                        "account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
                        "referrer": "0xD4eb4cbB1ECbf96a1F0C67D958Ff6fBbB7B037BB",
                        "referrerFee": "",
                        "enabledDexIds": "",
                        "disabledDexIds": "",
                        "sender": ""
                    }
                },
                "account": "0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532",
                "createAt": "2025-04-07T08:04:46.000Z"
            }
        ]
}