Pitlane API

Base URL: https://api.pitlane.sh

This API exposes venue discovery, transaction parsing, and risk analysis for Solana transactions. Human docs live here; machine-readable docs are available at /api/docs.json.

Routes

GET/health

Basic liveness probe.

Returns {"status":"ok"}.

{
  "status": "ok"
}

GET/api/venues

Lists every program currently registered in the parser dispatcher.

Response items include name and program_id.
Useful for feature discovery and coverage checks.

curl https://api.pitlane.sh/api/venues

[
  {
    "name": "system",
    "program_id": "11111111111111111111111111111111"
  },
  {
    "name": "token",
    "program_id": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
  }
]

POST/api/parse

Parses a submitted Solana transaction into a normalized instruction tree. The server simulates the transaction internally against its configured RPC endpoint.

Request body field: transaction_b64.
transaction_b64 must be base64 bincode of a legacy or versioned transaction.
The server calls simulateTransaction with inner instructions enabled.

curl -X POST https://api.pitlane.sh/api/parse \
  -H 'content-type: application/json' \
  -d '{
    "transaction_b64": "<base64-bincode-transaction>"
  }'

{
  "err": null,
  "fee_payer": "11111111111111111111111111111111",
  "instructions": [
    {
      "accounts": [
        "11111111111111111111111111111111",
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
      ],
      "data_b64": "AgAAAAcAAAAAAAAA",
      "decode_error": null,
      "decoded": {
        "instruction": {
          "Transfer": {
            "lamports": 7
          }
        },
        "program": "system"
      },
      "events": [],
      "inner": [],
      "label": "Transfer",
      "program": "system",
      "program_id": "11111111111111111111111111111111"
    }
  ],
  "recent_blockhash": "EkSnNWidFakeExampleRecentBlockhash111111111111111",
  "units_consumed": 12345,
  "version": "legacy"
}

POST/api/risk

Runs the same parse pipeline, then attaches per-instruction risk and returns transaction-level rolled up risk.

Accepts the exact same request body as /api/parse.
The server simulates first, then runs risk over the parsed output.
Response adds overall_risk and fills instruction.risk for each parsed instruction.

curl -X POST https://api.pitlane.sh/api/risk \
  -H 'content-type: application/json' \
  -d '{
    "transaction_b64": "<base64-bincode-transaction>"
  }'

{
  "err": null,
  "fee_payer": "11111111111111111111111111111111",
  "instructions": [
    {
      "accounts": [
        "11111111111111111111111111111111",
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
      ],
      "data_b64": "AgAAAAcAAAAAAAAA",
      "decode_error": null,
      "decoded": {
        "instruction": {
          "Transfer": {
            "lamports": 7
          }
        },
        "program": "system"
      },
      "events": [],
      "inner": [],
      "label": "Transfer",
      "program": "system",
      "program_id": "11111111111111111111111111111111",
      "risk": {
        "factors": [
          {
            "code": "SYSTEM_TRANSFER",
            "message": "Transfers 7 lamports",
            "severity": "low"
          }
        ],
        "level": "low",
        "score": 25
      }
    }
  ],
  "overall_risk": {
    "instructions_assessed": 1,
    "level": "low",
    "score": 25
  },
  "recent_blockhash": "EkSnNWidFakeExampleRecentBlockhash111111111111111",
  "units_consumed": 12345,
  "version": "legacy"
}