Get layer result

Each layer represents one level of depth in the BFS (breadth-first search) graph traversal. Layer 0 is the root address, layer 1 includes its direct counterparties, layer 2 their counterparties, and so on.

Request

curl https://api.wavynode.com/v1/analysis/{analysisId}/layers/{layer} \
  -H "x-api-key: ApiKey wavy_..."

Path parameters

Parameter	Type	Description
`analysisId`	string (uuid)	The analysis ID from the tracker service
`layer`	integer	The BFS depth level to fetch (0-based)

Response — completed layer

{
  "success": true,
  "data": {
    "analysisId": "2912b99e-ddb7-41bf-af29-fa0136361bf7",
    "layer": 1,
    "status": "completed",
    "riskScore": 46,
    "isProvisional": true,
    "totalLayers": 7,
    "detectedPatterns": [
      {
        "patternType": "high_value_transfers",
        "confidence": 0.85,
        "severity": "medium",
        "description": "Multiple high-value transfers detected"
      }
    ],
    "newPatterns": [
      {
        "patternType": "high_value_transfers",
        "confidence": 0.85,
        "severity": "medium",
        "description": "Multiple high-value transfers detected"
      }
    ],
    "removedPatterns": [],
    "cumulativeGraph": {
      "rootAddress": "0x47ac0fb4f2d84898e4d9e7b4dab3c24507a6d503",
      "nodes": { "0x47ac...": { "address": "0x47ac...", "type": "eoa" } },
      "edges": [{ "from": "0x47ac...", "to": "0xabcd...", "value": "1000000000" }],
      "metadata": { "totalNodes": 15, "totalEdges": 42 }
    },
    "newNodes": { "0xabcd...": { "address": "0xabcd...", "type": "eoa" } },
    "newEdges": [{ "from": "0x47ac...", "to": "0xabcd...", "value": "1000000000" }],
    "layerMetadata": {
      "processingTimeMs": 2340,
      "nodeCount": 15,
      "edgeCount": 42,
      "newNodeCount": 12,
      "newEdgeCount": 38,
      "errorCount": 0,
      "patternDetectionTimeMs": 180,
      "timestamp": "2026-04-29T16:22:32.000Z"
    }
  }
}

Response — pending layer

If the requested layer hasn’t been processed yet:

{
  "success": true,
  "data": {
    "analysisId": "2912b99e-ddb7-41bf-af29-fa0136361bf7",
    "layer": 5,
    "status": "pending",
    "totalLayers": 7
  }
}

Response fields

Field	Type	Description
`analysisId`	string	The analysis identifier
`layer`	integer	The BFS depth level
`status`	string	`completed`, `pending`, or `failed`
`riskScore`	number	Provisional risk score at this depth (0–100)
`isProvisional`	boolean	`true` for all layers except the final one
`totalLayers`	integer	Maximum depth (for progress calculation)
`detectedPatterns`	array	All patterns detected in the cumulative graph up to this layer
`newPatterns`	array	Patterns first detected at this layer
`removedPatterns`	array	Patterns from the previous layer no longer detected
`cumulativeGraph`	object	Full transaction graph from root to this depth
`newNodes`	object	Nodes added at this layer
`newEdges`	array	Edges added at this layer
`layerMetadata`	object	Processing statistics for this layer

The layer parameter is 0-based. Layer 0 is the root address analysis. If maxDepth is 7, valid layers are 0 through 6.

Caching

Completed layers are immutable. The API returns Cache-Control: public, max-age=3600 for completed layers, so clients can safely cache them. Pending layers return Cache-Control: no-cache.

Pattern diffing

Each layer includes newPatterns and removedPatterns relative to the previous layer. This enables incremental UI updates — you can highlight newly detected patterns without re-processing the entire list.

Layer	Detected	New	Removed	Interpretation
0	0	0	0	Root address only, no patterns yet
1	1	1	0	First pattern detected at depth 1
2	2	1	0	Additional pattern found at depth 2
3	1	0	1	One pattern no longer detected with more context

Introduction

Chains

Addresses

Status

Scan Risk

Investigations

Analysis

Reports

API Keys

Request

Path parameters

Response — completed layer

Response — pending layer

Response fields

Caching

Pattern diffing

​Request

​Path parameters

​Response — completed layer

​Response — pending layer

​Response fields

​Caching

​Pattern diffing

Request

Path parameters

Response — completed layer

Response — pending layer

Response fields

Caching

Pattern diffing