Vigil API Reference

The Vigil API provides programmatic access to MEV-protected transaction submission, real-time execution tracking, and rebate settlement on Solana. Build with confidence — every transaction is shielded.

bolt

Sub-400ms Execution

Optimized routing through Jito bundles and multi-path submission ensures your transactions land in under 400ms.

account_balance_wallet

Rebate Settlement

Automated MEV rebates returned directly to your wallet. Track captured value via the receipt endpoint.

infoBase URL: https://api.vigil.sh/v1

lock

Authentication

All API requests require a Bearer token in the Authorization header. Generate keys from the Vigil Dashboard.

Header

Authorization: Bearer vgl_sk_live_abc123...

warningKeep your secret key secure. Do not expose it in client-side code or public repositories.

POST

Send Transaction

Submit a serialized transaction for MEV-protected execution. Returns a transaction hash and protection metadata.

POST /v1/tx/send

Parameters

transactionrequiredstring

Base64-encoded serialized transaction. Must be a valid Solana transaction.

protection_leveloptionalenum

Level of MEV protection. standardenhancedmaximum

skip_preflightoptionalboolean

Skip preflight simulation before submitting. Default: false

TypeScript

import { VigilClient } from '@vigil/sdk';

const vigil = new VigilClient({
  apiKey: 'vgl_sk_live_abc123...',
  network: 'mainnet-beta',
});

const result = await vigil.sendTransaction({
  transaction: serializedTx,
  protectionLevel: 'enhanced',
  skipPreflight: false,
});

// Get MEV receipt
const receipt = await vigil.getReceipt(
  result.hash
);

200 OK — Response

{
  "success": true,
  "hash": "5UfDuX...9kPqR",
  "protection": {
    "level": "enhanced",
    "route": "jito_bundle",
    "latency_ms": 347
  },
  "slot": 281493027,
  "timestamp": "2026-04-07T09:23:01Z"
}

GET

MEV Receipt

Retrieve the MEV protection receipt for a submitted transaction. Includes captured MEV value, rebate amount, and settlement status.

GET /v1/tx/{hash}/receipt

Path Parameters

hashrequiredstring

The transaction signature returned from the send endpoint.

Response Fields

mev_capturedoptionalnumber

Total MEV value captured (in SOL).

rebate_amountoptionalnumber

Rebate returned to user wallet (in SOL).

settlement_statusoptionalenum

Current state: pendingsettledfailed

MEV Receipt — Response

{
  "hash": "5UfDuX...9kPqR",
  "mev_captured": 0.00823,
  "rebate_amount": 0.00691,
  "rebate_pct": 84,
  "settlement_status": "settled",
  "rebate_tx": "3xRt7m...Wk2pN",
  "settled_at": "2026-04-07T09:23:04Z"
}

GET

Protection Status

Check the real-time status of MEV protection services, including current latency and active protection routes.

GET /v1/protection/status

Response Fields

statusoptionalenum

Overall service health: operationaldegradedoutage

jito_bundle_latency_msoptionalnumber

Current average Jito bundle submission latency in ms.

active_routesoptionalnumber

Number of active protection routing paths.

speed

Rate Limits

API requests are rate-limited per API key. Limits vary by plan tier. Exceeded limits return 429 Too Many Requests.

Plan	Req / min	Burst
Community	60	10
Professional	600	50
Sovereign	Unlimited	Custom

settings

Settings

Manage your API keys, webhook endpoints, default protection levels, and rebate wallet addresses from the Vigil Dashboard. Programmatic configuration via API coming soon.