> For the complete documentation index, see [llms.txt](https://docs.theangel.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theangel.app/api-and-technical-documentation/webhooks.md).

# Webhooks

TheAngel provides event-driven webhooks for real-time updates.

***

### Available Events

#### 1. token.purchased

Triggered when investor buys tokens.

```solidity
{
  "event": "token.purchased",
  "data": {
    "investorId": "inv_004",
    "tokenId": "tok_001",
    "quantity": 200
  }
}
```

#### 2. token.transferred

Triggered during liquidity windows.

#### 3. wallet.verified

Investor wallet activated.

#### 4. listing.updated

Founder updates key metrics.

#### 5. liquidity.opened

Announcements for trading periods.

***

### Error Codes

#### 400 — Bad Request

Invalid parameters.

#### 401 — Unauthorized

Incorrect or missing API key.

#### 403 — Forbidden

Investor does not meet compliance requirements.

#### 429 — Rate Limited

Too many requests.

#### 500 — Internal Server Error

Unexpected platform issue.

***

### Rate Limits

* Standard: 60 requests/min
* Partner: 200 requests/min
* Enterprise: Custom

***

### Security & Compliance Notes

#### API Data Is Read-Only for Most Users

Write-enabled endpoints require enhanced verification.

#### PII Is Only Delivered Where Legally Permissible

Sensitive data is masked unless required.

#### All API Activity Is Logged

Including timestamps and IP addresses.

***

### Example Integrations

#### 1. Portfolio Tracker

Build dashboards pulling:

* Token prices
* Holdings
* Valuation changes

#### 2. CRM for Angel Syndicates

Automate deal alerts and syndicate participation.

#### 3. Treasury Management Tools

Track liquidity events and portfolio allocation.

#### 4. Exchange Integrations (Future)

Allow regulated secondary market trading.

***

### Summary — Why TheAngel API Matters

TheAngel’s API architecture:

| Benefit                    | Value                                |
| -------------------------- | ------------------------------------ |
| Standardisation            | Easy integration with modern tools   |
| Compliance-gated           | Prevents unregulated activity        |
| ISIN metadata              | Institutional-level transparency     |
| Smart contract enforcement | Ensures safe transfers               |
| Real-time events           | Supports algorithmic decision-making |
| Scalable                   | Built for long-term ecosystem growth |

It is designed to support a new era of tokenised private-market investing.