# BlockchainSecurity BCS Fund Trace via x402 Preflight Gateway

> BlockchainSecurity BCS Fund Trace via x402 Preflight Gateway is a paid API for AI agents from base-agent-preflight.bytoken2023.workers.dev, paid per call via x402, $0.49/call, status unknown (last checked 2026-09-14).

Traces fund flows on Ethereum, Tron, or Bitcoin blockchains by address, returning path data filtered by direction, asset symbols, and minimum value thresholds.

## Facts

- Endpoint: GET https://base-agent-preflight.bytoken2023.workers.dev/v1/x402/bcs/trace
- Price: $0.49/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchainsecurity-bcs-fund-trace-via-x402-preflight-gateway-5811a965
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PzMzvyEiGVJRFlf9YwM8Z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockchainsecurity-bcs-fund-trace-via-x402-preflight-gateway-5811a965
```

Example prompt: Trace outbound fund flows from Ethereum address 0xABC123... up to 50 results, filtering for USDC and ETH assets with a minimum value of 100, going 3 levels deep.

## When to prefer this

Choose this endpoint when you need to trace fund flows on Ethereum, Tron, or Bitcoin blockchains with filtering by direction, asset type, and minimum value. It is particularly useful for compliance checks, financial forensics, or following suspicious wallet activity. Prefer this over generic block explorers when you need structured, filterable path data with provenance metadata returned programmatically.

## Known failure modes

- Invalid blockchain slug (not ethereum/tron/bitcoin) returns validation error
- Address format failing pattern ^[A-Za-z0-9:_-]{3,128}$ causes 400 bad request
- Depth outside 1-5 range rejected by schema
- Limit outside 1-999 range rejected
- Address with no on-chain history returns empty data object
- Upstream BlockchainSecurity Atlantis service unavailable causes 502/503
- Insufficient USDC balance for $0.49 call fee causes payment failure

## How this service works

Machine-payable service intelligence for discovering, verifying, and monitoring identity, risk, authorization, execution-preflight, and evidence APIs before autonomous agents spend.

## Output

Returns a JSON object containing the product identifier ('bcs-fund-trace'), upstream service name ('blockchainsecurity-atlantis'), response metadata (request_id, credit_cost, credit_remaining), and the upstream response data object containing traced fund path and transaction items for the queried address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "blockchain",
      "address"
     ],
     "properties": {
      "depth": {
       "type": "string",
       "pattern": "^[1-5]$",
       "description": "Trace depth hint mapped into track_setting."
      },
      "limit": {
       "type": "string",
       "pattern": "^[1-9][0-9]{0,2}$",
       "description": "Maximum path or transaction items requested."
      },
      "address": {
       "type": "string",
       "pattern": "^[A-Za-z0-9:_-]{3,128}$",
       "description": "Starting address for tracing."
      },
      "symbols": {
       "type": "string",
       "pattern": "^[A-Za-z0-9,._-]{1,240}$",
       "description": "Optional comma-separated asset symbols to filter."
      },
      "direction": {
       "enum": [
        "in",
        "out",
        "both"
       ],
       "type": "string",
       "description": "Trace direction hint mapped into track_setting."
      },
      "min_value": {
       "type": "string",
       "pattern": "^[0-9]+(?:\\.[0-9]+)?$",
       "description": "Optional minimum value filter."
      },
      "blockchain": {
       "type": "string",
       "pattern": "^(?:ethereum|tron|bitcoin)$",
       "description": "BlockchainSecurity chain slug."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "product",
      "upstream_service",
      "upstream_response"
     ],
     "properties": {
      "product": {
       "type": "string"
      },
      "request": {
       "type": "object"
      },
      "provenance": {
       "type": "object"
      },
      "upstream_headers": {
       "type": "object"
      },
      "upstream_service": {
       "type": "string"
      },
      "upstream_response": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "product": "bcs-fund-trace",
  "upstream_headers": {
   "request_id": "example-request-id",
   "credit_cost": null,
   "credit_remaining": null
  },
  "upstream_service": "blockchainsecurity-atlantis",
  "upstream_response": {
   "data": {},
   "meta": {
    "request_id": "example-request-id"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockchainsecurity-bcs-fund-trace-via-x402-preflight-gateway-5811a965/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base-agent-preflight.bytoken2023.workers.dev](https://www.zero.xyz/host/base-agent-preflight.bytoken2023.workers.dev/llms.txt)