Intent Solver notify#
POST /notify#
Receives notifications for specific reasons, such as the solver being disabled due to a penalty.
bash
curl -X POST 'https://your-api-endpoint.com/OKXDEX/intent/notify' \
-H 'Content-Type: application/json' \
-d '{
"reason": "Non-winner submitted on-chain",
"action": "Disable immediately",
"chainIndex": "42161",
"details": "{\"reason\":\"solution_not_found\",\"settleId\":16977970092880320}"
}'
Request Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
| reason | String | Yes | Penalty reason |
| action | String | Yes | Penalty action |
| chainIndex | String | No | Chain index where the penalty was triggered |
| details | String | No | JSON-encoded string with additional context (e.g. internal reason code, settleId) |
Penalty Reasons & Actions#
| Code | Reason | Action |
|---|---|---|
| 1 | Non-winner submitted on-chain | Disable immediately |
| 2 | Low order on-chain success rate | Disable for 3 hours |
| 3 | Malicious quote - auction failed | Disable immediately |
| 4 | Malicious quote - low on-chain success rate | Manual review |
| 5 | EBBO violation | Disable for 24 hours |
| 6 | Inflated score | Disable for 24 hours |
| 7 | Score inflation | Remove from whitelist |
| 8 | Unfair surplus transfer | Disable for 24 hours |
Request Example#
json
{
"reason": "Non-winner submitted on-chain",
"action": "Disable immediately"
}
Response Example#
json
{
"code": 0,
"msg": "success",
"data": null
}