API Overview

TheAngel provides a suite of APIs and smart contract interfaces designed to enable seamless integration with external systems, wallets, analytics tools, and partner platforms.

This documentation describes the available endpoints, authentication mechanisms, smart contract structure, and webhook events.

The goal is to support:

• Wallet integrations

• Founder dashboards

• Investor analytics tools

• Third-party marketplaces

• Internal automation

---

Overview

TheAngel APIs allow developers to:

• Retrieve startup listing data

• Access investor portfolio data

• Execute token operations (where permitted)

• Retrieve token and valuation metadata

• Subscribe to liquidity-related events

• Integrate secure identity and compliance verification

---

API Architecture

TheAngel API is built with:

• REST + Webhook support

• JWT-based authentication

• Enforced TLS encryption

• Compliance-gated endpoints

• Standardised data models

• Role-based access controls (RBAC

---

Authentication

Authentication Method

TheAngel uses JWT (JSON Web Tokens) for all API calls.

Steps to Authenticate

1. Request API Key

Developers generate a key via:

POST /developer/api-key

2. Authenticate with Credentials

POST /auth/token
Content-Type: application/json
{
  "apiKey": "YOUR_API_KEY",
  "secret": "YOUR_SECRET"
}

3. Response

{
  "accessToken": "JWT_TOKEN",
  "expiresIn": 3600
}

4. Include Token in Headers

Authorization: Bearer JWT_TOKEN