Skip to main content
POST
/
mev
/
discover-competitors
Discover MEV Competitors
curl --request POST \
  --url https://api.soltop.sh/mev/discover-competitors \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "wallet_address": "FnmStvzQ27Pm4U8r3M6gPD7mnk6ST6HwraPsoNmYpump",
  "time_range_days": 7,
  "min_interactions": 3,
  "limit": 20,
  "slot_window": 4
}
'
{
  "success": true,
  "jobId": "abc123def456",
  "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

Target wallet address to analyze (base58, 32-44 characters)

Pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
Example:

"FnmStvzQ27Pm4U8r3M6gPD7mnk6ST6HwraPsoNmYpump"

​
time_range_days
integer
default:7

Number of days to analyze

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

7

​
min_interactions
integer
default:3

Minimum number of interactions to consider a competitor

Required range: x >= 1
Example:

3

​
limit
integer
default:20

Maximum number of competitors to return

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

20

​
slot_window
integer
default:4

Slot window for considering proximity (±N slots)

Required range: x >= 1
Example:

4

Response

Job submitted successfully or cached result returned

Job queued response

​
success
boolean
Example:

true

​
jobId
string
Example:

"abc123def456"

​
status
string
Example:

"queued"

​
message
string
Example:

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