pulse

Refine

Strips bot activity from raw on-chain transaction data. Returns clean, structured JSON ready for LLM analysis.

Endpoint: POST https://distill-agent-production.up.railway.app/entrypoints/process/invoke Price: 0.02 USDC/call Network: Base Mainnet (eip155:8453)

Why

Raw blockchain transaction data is full of noise — wash trading, contract deployers, CEX wallets. Feed this directly to an LLM and it produces inaccurate results. Refine removes the noise before it reaches your agent.

Request

Send the rows under a data array. Column names are flexible — Refine auto-detects address / amount / timestamp / hash columns from your data.

{
  "data": [
    {
      "tx_hash": "0xabc...",
      "tx_from_address": "0x123...",
      "amount": "1000000",
      "timestamp": "2026-05-28T20:13:59Z"
    }
  ]
}

Response

{
  "summary": {
    "total_transactions": 100,
    "bot_filtered": 13,
    "suspicious": 0,
    "clean_transactions": 87,
    "bot_ratio": "13%"
  },
  "warnings": {
    "noAddressColumn": false,
    "noAmountColumn": false,
    "noTimestampColumn": false
  },
  "features": {
    "totalVolume": 1250,
    "cleanVolume": 1250,
    "suspiciousVolume": 0,
    "botVolume": 0,
    "volumeConfidence": "100%",
    "uniqueCounterparties": 2,
    "avgTransactionSize": 625,
    "peakActivity": "20:00-21:00 UTC",
    "recurringPatterns": []
  },
  "clean_data": [],
  "suspicious_data": []
}

curl example

curl -X POST https://distill-agent-production.up.railway.app/entrypoints/process/invoke \
  -H "Content-Type: application/json" \
  -d '{"data": [...]}'
# Returns 402 — pay via Test Agent UI at https://quitx5454.github.io/pulse

Distill Standard Envelope

Every Distill agent optionally accepts a standard envelope and always replies with one. It’s backward compatible — send the wrapper or don’t, your existing calls keep working.

Envelope mode — wrap your payload:

{
  "distill_version": "1.0",
  "agent_id": "6482",
  "session_id": "test-session-001",
  "payload": {
    "data": [
      { "tx_hash": "0xabc...", "tx_from_address": "0x123...", "amount": "1000000", "timestamp": "2026-05-28T20:13:59Z" }
    ]
  }
}

distill_version, agent_id, and session_id are all optional. Omit session_id and one is generated for you (UUID).

Legacy mode — send the request directly, no wrapper (exactly as in Request above). Still works.

Response — always enveloped:

{
  "distill_version": "1.0",
  "agent_id": "6482",
  "session_id": "test-session-001",
  "status": "ok",
  "output": {
    "summary": { "total_transactions": 100, "bot_filtered": 13, "suspicious": 0, "clean_transactions": 87, "bot_ratio": "13%" },
    "features": { "totalVolume": 1250, "cleanVolume": 1250, "uniqueCounterparties": 2, "avgTransactionSize": 625 },
    "clean_data": [],
    "suspicious_data": []
  },
  "processed_at": "2026-06-02T16:21:11.827Z"
}