Use Cases
Practical workflows for detecting and investigating MEV activity using the Blockline API.Detect & Investigate Sandwich Attacks
The most common workflow: scan your wallet for sandwich attacks, then drill into specific attackers.The 3-Step Flow
1
Scan your wallet
Use
check-wallet to find all sandwiched trades in the last 1–4 days.2
Review results
Identify which attackers are targeting you and how often.
3
Investigate an attacker
Use
check-attacker to get a full profile: which DEXes, validators, pools, and timing patterns.Step 1: Scan your wallet
Submit your wallet address to find all DEX trades that were sandwiched.jobId — poll /mev/job-status/:jobId until the job completes:
Example response (trimmed)
Example response (trimmed)
incidents array shows the attacker wallet DDm1Bc9... placed transactions both before (sandwich_frontrun) and after (sandwich_backrun) the victim’s trade in the same slot.
Step 2: Quick-check a specific transaction
Already know which transaction to check? Use the synchronouscheck-sandwich-fast endpoint for an instant result — no job polling needed.
Example response
Example response
DDm1Bc9...) sent multiple attempts — two frontrun and two backrun transactions. One of each failed (success: false), which is typical MEV bot behavior: they spam transactions to maximize their chance of landing.
slot_range: 0 means intra-slot only — the attacker’s transactions must be in the same slot as the victim. Use higher values (e.g., 1 or 5) to catch cross-slot sandwiches.Step 3: Investigate the attacker
Now that you’ve identifiedDDm1Bc9KuXB7Q2UbxyMRLGmbcV2J93xmiWDPt7Edhqbs as a sandwich attacker, get their full profile.
Example response
Example response
Choosing the Right Endpoint
Front-Running Detection
Analyze transactions that occurred before yours in the same slot to detect potential front-running.Speed Ranking
Compare where transactions landed in their blocks (block_tx_index, and position_offset on sandwich legs) to understand execution speed advantages.
Pattern Recognition
Identify recurring MEV patterns and bot behavior in specific markets.More detailed guides for these use cases are coming soon.