# Embed Your LOBSTER Score

Display your trust score on any website with our embeddable widget.

## Quick Start

Add these two lines to any HTML page to display your LOBSTER score:

```
<!-- Load the widget script -->
<script src="https://paylobster.com/widget.js"></script>

<!-- Add the widget element -->
<div data-lobster-score="YOUR_WALLET_ADDRESS"></div>
```

## Live Demo

Here's how the widget looks with different configurations:

### Compact

🦞 LOBSTER  
782  
★ ELITE ★

### Standard

🦞 LOBSTER Score  
782  
★ ELITE ★

[Verify on Pay Lobster →](https://paylobster.com/dashboard/developer)

### Light Theme

🦞 LOBSTER Score  
782  
★ ELITE ★

[Verify on Pay Lobster →](https://paylobster.com/dashboard/developer)

## Customization Options

| Attribute          | Values                   | Default   | Description                           |
|--------------------|-------------------------|-----------|---------------------------------------|
| data-lobster-score | 0x...                   | -         | Your wallet address (required)       |
| data-theme         | dark, light             | dark      | Color scheme                         |
| data-size          | compact, standard, full  | standard  | Widget size                          |
| data-show-link     | true, false             | true      | Show verification link               |

## Code Examples

### Compact Dark Widget

```
<div
  data-lobster-score="0x1234...5678"
  data-size="compact"
  data-theme="dark"
></div>
```

### Full Widget with Stats

```
<div
  data-lobster-score="0x1234...5678"
  data-size="full"
  data-theme="dark"
></div>
```

### Light Theme Without Link

```
<div
  data-lobster-score="0x1234...5678"
  data-theme="light"
  data-show-link="false"
></div>
```

## API Badge (Advanced)

You can also fetch badge data programmatically:

```
GET https://paylobster.com/api/badge/0x1234...5678?format=json

Response:
{
  "address": "0x1234...5678",
  "score": 782,
  "tier": "ELITE",
  "transactions": 47,
  "registered": "2026-01-15T..."
}
```

Or get an SVG badge:

```
<img src="https://paylobster.com/api/badge/0x1234...5678?format=svg" alt="LOBSTER Score" />
```

## Trust Check API

Get trust alerts and recommendations before transacting:

```
GET https://paylobster.com/api/trust-check/0x1234...5678

Response:
{
  "address": "0x1234...5678",
  "score": 782,
  "alerts": [
    {
      "type": "all_clear",
      "severity": "info",
      "message": "No concerns detected"
    }
  ],
  "recommendation": "safe"
}
```

Recommendation Values:

- `safe` - No concerns detected
- `proceed_with_caution` - Minor warnings present
- `high_risk` - Significant concerns detected