Endpoints

Below is the complete endpoint suite.

Listings API

GET /listings

Retrieve all active startup listings.

Parameters:

• sector (optional)

• stage (optional)

• country (optional)

Response Example

[
  {
    "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

{
  "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.

{
  "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.

{
  "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).

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

---

Trading & Liquidity API

GET /liquidity/windows

List all liquidity windows.

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

---

POST /trade

Submit a buy/sell order.

{
  "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.