# Wallet Transactions (Wins) Endpoint

Pull the receipts for any wallet — returns all successful arbitrage transaction signatures (and total count) for a given signer within a set aggregation window.

Perfect for tracking performance, auditing a competitor, or building leaderboards.

**Note:** we do NOT track dust transactions < 0.00005 SOL trade sizes.

<mark style="color:green;">**`POST`**</mark> `https://api.getfomo.bot/wallet/wins`

**Request**

```bash
curl -X POST https://api.getfomo.bot/wallet/wins \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key-here" \
  -d '{
    "wallet": "hifoTy5geDwq2SG32J7RXjLgB89UJGrtYYESA2dSYCh",
    "aggregation_window": 3600,
    "from_bots": []
  }'
```

**Body Fields**

<table><thead><tr><th width="235.3203125">Field</th><th width="118.01953125">Type</th><th width="142.41015625">Default</th><th>Description</th></tr></thead><tbody><tr><td><strong>wallet</strong></td><td>string</td><td>--</td><td>Wallet address (signer) to fetch transactions for.</td></tr><tr><td><strong>aggregation_window</strong></td><td>number</td><td>3600</td><td>Lookback window in seconds (max 43200).</td></tr><tr><td><strong>from_bots</strong></td><td>string[]</td><td>[]</td><td>Filter by MEV bots. Options: <code>smb</code>, <code>notarb</code>, (empty = no bot specific filtering)</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

```json
{
  "success": true,
  "count": 10,
  "transactions": [
    "5abc123def456...", 
    "7xyz789ghi012...", 
    "9jkl345mno678...", 
    "2pqr901stu234...", 
    "4vwx567yza890...",
    ...
  ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "Invalid wallet",
  "invalid": ["InvalidWallet123"]
}
```

{% endtab %}

{% tab title="429" %}

```json
{
  "error": "Rate limit exceeded",
  "limit": 50,
  "unit": "requests/second"
}
```

{% endtab %}
{% endtabs %}