> 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/endpoints.md).

# Endpoints

### Listings API

#### GET /listings

Retrieve all active startup listings.

Parameters:

* sector (optional)
* stage (optional)
* country (optional)

Response Example

```solidity
[
  {
    "id": "stp_001",
    "name": "NovaPay",
    "sector": "Fintech",
    "valuation": 3500000,
    "tokenPrice": 1.20,
    "raiseTarget": 450000,
    "raiseProgress": 72000,
    "status": "active"
  }
]
```

***

#### GET /listings/{id}

Retrieve a specific listing.

Response Example

```solidity
{
  "id": "stp_001",
  "name": "NovaPay",
  "description": "Next-gen payments for freelancers",
  "problem": "Cross-border freelancers face slow and expensive payments",
  "solution": "Instant multi-currency payment rails via blockchain",
  "sector": "Fintech",
  "team": [
    {"name": "Sarah Kim", "role": "CEO"},
    {"name": "David Lee", "role": "CTO"}
  ],
  "tokenomics": {
    "tokenSupply": 500000,
    "tokenPrice": 1.20,
    "valuation": 3500000
  },
  "documents": [
    {"title": "Pitch Deck", "url": "https://.../deck.pdf"}
  ]
}
```

***

### Investor Portfolio API

#### GET /investor/portfolio

Returns an investor’s token holdings.

```solidity
{
  "investorId": "inv_004",
  "totalValue": 18320,
  "holdings": [
    {
      "tokenId": "tok_001",
      "startup": "NovaPay",
      "quantity": 1500,
      "currentPrice": 1.35,
      "currentValue": 2025
    }
  ]
}
```

***

#### GET /investor/transactions

Retrieve investor trade, purchase, and transfer history.

***

#### GET /investor/valuation-history

Retrieve valuation changes across all holdings.

***

### Token Metadata API

#### GET /tokens/{tokenId}

Retrieve metadata about a tokenised equity instrument.

```solidity
{
  "tokenId": "tok_001",
  "startupId": "stp_001",
  "ISIN": "LU1234567890",
  "tokenName": "NovaPay Equity Token",
  "supply": 500000,
  "price": 1.35,
  "valuation": 3500000,
  "compartmentId": "cmp_001"
}
```

***

#### GET /tokens/{tokenId}/price-history

Retrieve price data for liquidity windows.

***

#### GET /tokens/{tokenId}/compartment

Return the legal structure information (read-only).

```solidity
{
  "compartmentId": "cmp_001",
  "jurisdiction": "Luxembourg",
  "structure": "Securitisation Fund Compartment",
  "bankruptcyRemote": true
}
```

***

### Trading & Liquidity API

#### GET /liquidity/windows

List all liquidity windows.

```solidity
[
  {
    "id": "lw_001",
    "status": "scheduled",
    "opens": "2025-04-01T00:00:00Z",
    "closes": "2025-04-05T23:59:59Z"
  }
]
```

***

#### POST /trade

Submit a buy/sell order.

```solidity
{
  "tokenId": "tok_001",
  "type": "buy",
  "quantity": 500,
  "maxPrice": 1.40
}
```

***

#### GET /trade/status/{tradeId}

Track status of a trade.

***

### Compliance API

#### POST /compliance/kyc

Submit investor documents for verification.

***

#### GET /compliance/status

Retrieve compliance or accreditation status.