> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Getting Started with Blnk Watch
> Learn how to install, configure, and run Blnk Watch to monitor transactions with custom risk rules.
export const CtaCallout = props => {
const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
const handleCtaClick = () => {
if (typeof window === "undefined" || !trackingEvent) {
return;
}
try {
window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
detail: {
name: trackingEvent,
href
}
}));
} catch {}
try {
window.posthog?.capture?.(trackingEvent, {
href
});
} catch {}
const gaPayload = {
cta_href: href
};
try {
window.gtag?.("event", trackingEvent, gaPayload);
} catch {}
try {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: trackingEvent,
...gaPayload
});
} catch {}
};
const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
const linkRel = isExternal ? rel : undefined;
return ;
};
Blnk Watch is currently in beta. [Send us a message](mailto:support@blnkfinance.com)
Blnk Watch is a lightweight, rule-based transaction monitoring engine.
Watch evaluates transactions using rules written in a simple domain specific language (DSL) called WatchScript `.ws`.
Here's how it works: you send transactions to Watch, and it returns a risk verdict, so you can enforce limits, detect fraud, and stay compliant without running heavy infrastructure.
Get hands-on help setting up transaction monitoring, managing rules, alerts, and reporting with Blnk Watch.
In this quick start, you will:
1. Start the Watch service
2. Write a rule
3. Send a transaction for evaluation
4. See the risk decision
Let's dive in!
***
Install Watch with direct download (no repo or Go required), then start the service:
```bash theme={"system"}
curl -fsSL https://blnkfinance.xyz/install/watch | bash
blnk-watch start
```
Download Watch from the repository and run it:
```bash theme={"system"}
git clone https://github.com/blnkfinance/watch && cd watch
```
```bash macOS/Linux theme={"system"}
make start
```
```bash Windows theme={"system"}
go build -o blnk-watch ./cmd/blnk-watch
./blnk-watch start
```
By default Watch listens on port 8081. The service is ready when it starts listening on the port.
Create a rules directory and add a rule file:
```bash theme={"system"}
mkdir -p watch_scripts && cd watch_scripts
touch HighValueUSD.ws
```
Add this rule to `HighValueUSD.ws`:
```bash theme={"system"}
rule HighValueUSD {
description "Flag USD transactions over 4,000 for review"
when amount > 4000 and currency == "USD"
then review
score 0.5
reason "USD transaction exceeds 4,000"
}
```
This rule triggers for any USD transaction above \$4,000.
Use the [inject endpoint](/watch/reference/inject-transaction) to send a transaction to Watch.
```bash Request {5,6} theme={"system"}
curl -X POST http://localhost:8081/inject \
-H "Content-Type: application/json" \
-d '{
"transaction_id": "txn_quickstart_001",
"amount": 5000,
"currency": "USD",
"source": "acct_sender",
"destination": "acct_receiver",
"reference": "ref_001",
"description": "Sample transfer"
}'
```
If successful (200), Watch queues the transaction for evaluation.
```json Response theme={"system"}
{
"message": "Call GET /transactions/{id} to fetch the processed transaction or set ALERT_WEBHOOK_URL to get webhooks when a rule triggers for the transaction.",
"transaction_id": "txn_quickstart_001"
}
```
Fetch the processed transaction:
```bash theme={"system"}
curl http://localhost:8081/transactions/txn_quickstart_001
```
You should see a response similar to:
```json Response theme={"system"}
{
"meta_data": {
"consolidated_risk_assessment": {
"final_reason": "USD transaction exceeds 4,000",
"final_risk_score": 0.5,
"final_verdict": "review",
"source_count": 1
},
"dsl_verdicts": [
{
"reason": "USD transaction exceeds 4,000",
"rule_id": 0,
"score": 0.5,
"verdict": "review"
}
],
"evaluation_status": "completed",
"risk_evaluation_timestamp": "2026-03-15T22:12:00.99813+01:00"
}
}
```
The verdict appears because the transaction amount, 5000 USD, triggered the rule.
Try sending another transaction with a smaller amount, such as 3000 USD. Because it does not meet the rule condition, the rule will not trigger. You can also experiment with different amounts or currencies to see how the rule behaves.
***
## Related docs
Watch releases and version history.
Evaluation workflow and verdicts.