Ticket API

This support Ticket API is designed for users who encounter errors or issues while using the OpenOcean quote or swap API. By utilizing this API, our system will assist you in identifying and analyzing the problem, enabling a timely resolution. To ensure effective support, you will be required to provide accurate and relevant parameters and information.

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 don't have one, please contact us

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:

Terminal

1 {
2     "hash": "0x0b5a4b1ab8ca47a2a2dbf4e6a998b39f6d40caed14f0ac3f3faaef27c8959593",
3     "chain": 56,
4     "version": "v2",
5     "question": "question",
6     "account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
7     "quote": {
8       "quoteType": "swap",
9       "inTokenSymbol": "BNB",
10       "inTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
11       "outTokenSymbol": "USDT",
12       "outTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
13       "amountAll": 1,
14       "amount": 1000000000000000000,
15       "gasPrice": 1100000000,
16       "slippage": 100,
17       "referrer": "0x3487ef9f9b36547e43268b8f0e2349a226c70b53",
18       "disabledDexIds": ""
19     },
20     "transaction": {
21         "from": "",
22         "to": "",
23         "value": "",
24         "data": "",
25         "gasPrice": "",
26         "gasLimit": ""
27     },
28     "error": {
29         "code": 400,
30         "error": "no router"
31     },
32 }

Response:

Parameter	Type	Example	Description
`ticket`	string	5298615415	ticket code

Response example:

Terminal

1 {
2     "code": 0,
3     "msg": "ok",
4     "data": {
5         "ticket": "5298615415"
6     }
7 }

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:

Terminal

1 {
2     "code": 200,
3     "data": [
4             {
5                 "hash": "0xcaf525986a879ca5017ca9b934a402aa55232c5e983b245937d39a3583c2c49a",
6                 "remark": null,
7                 "process": "01",
8                 "question": "question",
9                 "answer": null,
10                 "params": {
11                     "quote": {
12                         "chain": "bsc",
13                         "inTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
14                         "outTokenAddress": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
15                         "amount": 5,
16                         "gasPrice": 1,
17                         "slippage": 1,
18                         "account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
19                         "referrer": "0xD4eb4cbB1ECbf96a1F0C67D958Ff6fBbB7B037BB",
20                         "referrerFee": "",
21                         "enabledDexIds": "",
22                         "disabledDexIds": "",
23                         "sender": ""
24                     }
25                 },
26                 "account": "0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532",
27                 "createAt": "2025-04-07T08:04:46.000Z"
28             }
29         ]
30 }

1	{
2	"hash": "0x0b5a4b1ab8ca47a2a2dbf4e6a998b39f6d40caed14f0ac3f3faaef27c8959593",
3	"chain": 56,
4	"version": "v2",
5	"question": "question",
6	"account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
7	"quote": {
8	"quoteType": "swap",
9	"inTokenSymbol": "BNB",
10	"inTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
11	"outTokenSymbol": "USDT",
12	"outTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
13	"amountAll": 1,
14	"amount": 1000000000000000000,
15	"gasPrice": 1100000000,
16	"slippage": 100,
17	"referrer": "0x3487ef9f9b36547e43268b8f0e2349a226c70b53",
18	"disabledDexIds": ""
19	},
20	"transaction": {
21	"from": "",
22	"to": "",
23	"value": "",
24	"data": "",
25	"gasPrice": "",
26	"gasLimit": ""
27	},
28	"error": {
29	"code": 400,
30	"error": "no router"
31	},
32	}

1	{
2	"code": 0,
3	"msg": "ok",
4	"data": {
5	"ticket": "5298615415"
6	}
7	}

1	{
2	"code": 200,
3	"data": [
4	{
5	"hash": "0xcaf525986a879ca5017ca9b934a402aa55232c5e983b245937d39a3583c2c49a",
6	"remark": null,
7	"process": "01",
8	"question": "question",
9	"answer": null,
10	"params": {
11	"quote": {
12	"chain": "bsc",
13	"inTokenAddress": "0x55d398326f99059ff775485246999027b3197955",
14	"outTokenAddress": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
15	"amount": 5,
16	"gasPrice": 1,
17	"slippage": 1,
18	"account": "0x2FF855378Cd29f120CDF9d675E959cb5422ec5f2",
19	"referrer": "0xD4eb4cbB1ECbf96a1F0C67D958Ff6fBbB7B037BB",
20	"referrerFee": "",
21	"enabledDexIds": "",
22	"disabledDexIds": "",
23	"sender": ""
24	}
25	},
26	"account": "0x72f16Cae8F50Ad615AB5A8e231A496b2ace52532",
27	"createAt": "2025-04-07T08:04:46.000Z"
28	}
29	]
30	}