---
title: "Badge Builder — Free Scout Score & Commit Momentum SVG badges"
url: https://signals.gitdealflow.com/badge-builder
description: "Free shields.io-style SVG badges for any GitHub README. Scout Score for users, Commit Momentum tier for tracked repos. Auto-updates, no signup, no telemetry."
source: VC Deal Flow Signal
---
# Free README badges

Two free SVG endpoints render shields.io-style scoreboards from the same primitives that power /receipts and the Scout Game. Both are CORS-enabled, cache 24h on the CDN with hourly ETag revalidation, and always return a valid SVG (gray "pending" pill on errors) so READMEs never break.

## Scout Score badge — per GitHub user

`GET https://signals.gitdealflow.com/api/badge/scout/{username}/svg` renders the user's live Scout Score (0-100) and rank (curious / scout / sharp / elite / oracle) computed from their public starring history vs ~75 validated unicorn outcomes.

Markdown:

```markdown
[![Scout Score](https://signals.gitdealflow.com/api/badge/scout/USERNAME/svg)](https://signals.gitdealflow.com/badge-builder)
```

## Commit Momentum badge — per GitHub repo

`GET https://signals.gitdealflow.com/api/badge/momentum/{org}/{repo}/svg` renders the repo's commit-velocity tier (cold / warming / hot / breakout) computed from the live 14-day velocity change vs prior 14-day window. Untracked orgs render an "untracked" pill rather than a 404.

Markdown:

```markdown
[![Commit Momentum](https://signals.gitdealflow.com/api/badge/momentum/ORG/REPO/svg)](https://signals.gitdealflow.com/badge-builder)
```

## Tier mapping (Commit Momentum)

- **breakout** — velocity change >= +200%
- **hot** — velocity change >= +50%
- **warming** — velocity change >= -30%
- **cold** — velocity change < -30%

## Cache policy

Both endpoints set `Cache-Control: public, max-age=300, s-maxage=86400, stale-while-revalidate=604800`. GitHub's camo proxy respects the ETag (`{username}:{score}:{rank}` for Scout, `{org}/{repo}:{tier}:{change}` for Momentum), so revalidation is one HTTP HEAD per camo region per hour.

## Generator UI

Live preview + copy-paste markdown / HTML / BBCode at https://signals.gitdealflow.com/badge-builder. Accepts `?handle={username}` and `?org={org}&repo={repo}` URL params for pre-filled snippets.

## OpenAPI spec

Both endpoints are documented in https://signals.gitdealflow.com/api/openapi.json (operationIds: getScoutBadge, getMomentumBadge).

## Canonical

https://signals.gitdealflow.com/badge-builder