Skip to main content
POST
/
mev
/
check-wallet
Scan Wallet for Sandwich Attacks
curl --request POST \
  --url https://api.soltop.sh/mev/check-wallet \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "wallet_address": "8ENw3qJSzWGUV31BW5u2YEmsyp9XKjH1FxuwLhhwwMe2",
  "time_range_days": 1,
  "slot_window": 4
}
'
{
  "success": true,
  "jobId": "mev-wallet-check-abc123-1773926565328",
  "status": "queued",
  "message": "Analysis started. Poll /mev/job-status/:jobId for updates."
}

Authorizations

​
Authorization
string
header
required

Supabase JWT authentication. Used for MEV Analysis and Write Locks endpoints. Requires an active subscription (trial, active, or grace_period status).

Body

application/json
​
wallet_address
string
required

Wallet address to scan (base58)

Example:

"8ENw3qJSzWGUV31BW5u2YEmsyp9XKjH1FxuwLhhwwMe2"

​
time_range_days
integer
default:1

Number of days to analyze

Required range: 1 <= x <= 4
Example:

1

​
slot_window
integer
default:4

Slot window (±) for detecting attackers. 0 = intra-slot only.

Required range: 0 <= x <= 10
Example:

4

Response

Job submitted or cached result returned

Job queued

​
success
boolean
Example:

true

​
jobId
string
Example:

"mev-wallet-check-abc123-1773926565328"

​
status
string
Example:

"queued"

​
message
string
Example:

"Analysis started. Poll /mev/job-status/:jobId for updates."