Hiveround

List the newest open projects raising on Hiveround. Returns at most 25.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "stage": {
      "type": "string",
      "enum": [
        "idea",
        "prototype",
        "mvp",
        "launched",
        "revenue"
      ]
    }
  }
}

Search open projects by keyword across name, one-liner, description, and sector. Optional filters: stage, max raise size in USD.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search query"
    },
    "stage": {
      "type": "string",
      "enum": [
        "idea",
        "prototype",
        "mvp",
        "launched",
        "revenue"
      ]
    },
    "max_raise_usd": {
      "type": "number",
      "description": "Maximum raise size in USD"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "required": [
    "query"
  ]
}

Get the full project listing by slug, including the founder's GitHub handle.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Request an intro to a project's founder on behalf of the API key's owner. The founder receives an email with the investor's GitHub handle. (requires API key)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug"
    },
    "message": {
      "type": "string",
      "description": "Intro message from the investor (max 2000 chars)"
    }
  },
  "required": [
    "slug",
    "message"
  ]
}

Add a project to your pipeline (or update its stage). Stages: interested, diligence, intro_requested, passed, invested. Optional notes are appended to the watch's note log. (requires API key)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug"
    },
    "stage": {
      "type": "string",
      "enum": [
        "interested",
        "diligence",
        "intro_requested",
        "passed",
        "invested"
      ],
      "default": "interested"
    },
    "notes": {
      "type": "string",
      "description": "Optional note to append (max 4000 chars)"
    }
  },
  "required": [
    "slug"
  ]
}

Move a watched project to a new pipeline stage and/or append a note. The project must already be in your pipeline. (requires API key)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug"
    },
    "stage": {
      "type": "string",
      "enum": [
        "interested",
        "diligence",
        "intro_requested",
        "passed",
        "invested"
      ]
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Return your pipeline — every project you're watching, with stage, tags, raise size, and last-updated timestamp. Optionally filter by stage or tag. (requires API key)

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string",
      "enum": [
        "interested",
        "diligence",
        "intro_requested",
        "passed",
        "invested"
      ]
    },
    "tag": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    }
  }
}

List the intro threads you're a party to (sent as an investor or received as a founder). Each entry includes the counterparty, message count, last-message preview, and whether you have unread messages. Optionally filter by your role or unread-only. (requires API key)

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "investor",
        "founder"
      ],
      "description": "Filter to intros where you are the investor or the founder. Omit to see both."
    },
    "unread_only": {
      "type": "boolean",
      "default": false,
      "description": "Only return threads with unread messages from the counterparty."
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    }
  }
}

Read all messages in a specific intro thread you're a party to. Marks the thread as read for you. (requires API key)

{
  "type": "object",
  "properties": {
    "intro_id": {
      "type": "string",
      "description": "Intro UUID, as returned by list_intros or request_intro."
    }
  },
  "required": [
    "intro_id"
  ]
}

Append a message to an existing intro thread you're a party to. The other party gets an email notification linking back to the thread. Use this to follow up after request_intro or to keep a conversation moving. (requires API key)

{
  "type": "object",
  "properties": {
    "intro_id": {
      "type": "string",
      "description": "Intro UUID."
    },
    "body": {
      "type": "string",
      "description": "Message body (1–4000 chars)."
    }
  },
  "required": [
    "intro_id",
    "body"
  ]
}

Record an investor's intent-to-fund a project. Without terms it starts at 'soft_circled'; attach a terms object and it starts at 'term_sheet'. The founder still has to acknowledge — a commitment doesn't count as 'committed' (and doesn't show in the public round progress) until both sides have acked. (requires API key)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Project slug."
    },
    "amount_usd": {
      "type": "number",
      "minimum": 1,
      "description": "Commitment amount in USD (whole dollars)."
    },
    "instrument": {
      "type": "string",
      "enum": [
        "safe",
        "convertible_note",
        "equity",
        "other"
      ],
      "default": "safe"
    },
    "terms": {
      "type": "object",
      "description": "Optional structured terms, e.g. { cap: 8000000, discount: 0.20, mfn: true, valuation: 4000000, pro_rata: true }. Presence promotes initial status from soft_circled to term_sheet."
    },
    "intro_id": {
      "type": "string",
      "description": "Optional intro UUID to link this commitment to an existing conversation."
    },
    "notes": {
      "type": "string",
      "description": "Free-form note (max 4000 chars)."
    }
  },
  "required": [
    "slug",
    "amount_usd"
  ]
}

Acknowledge a commitment as the founder or the investor. When both sides have acknowledged, status auto-promotes from soft_circled/term_sheet to 'committed' and the amount is added to the project's public round progress. Calling twice from the same side is a no-op. (requires API key)

{
  "type": "object",
  "properties": {
    "commitment_id": {
      "type": "string",
      "description": "Commitment UUID."
    }
  },
  "required": [
    "commitment_id"
  ]
}

Change a commitment's status. Role-gated: only the investor can 'withdraw' a commitment, only the founder can mark it 'funded' (after the wire lands). Either side can move between soft_circled/term_sheet/committed. (requires API key)

{
  "type": "object",
  "properties": {
    "commitment_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "soft_circled",
        "term_sheet",
        "committed",
        "funded",
        "withdrawn"
      ]
    },
    "notes": {
      "type": "string",
      "description": "Optional note (max 4000 chars)."
    }
  },
  "required": [
    "commitment_id",
    "status"
  ]
}

List commitments where you're either the investor or the founder. Filter by project slug, your role, or status. (requires API key)

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Filter to a single project."
    },
    "role": {
      "type": "string",
      "enum": [
        "investor",
        "founder"
      ],
      "description": "Only commits where you're acting in this role."
    },
    "status": {
      "type": "string",
      "enum": [
        "soft_circled",
        "term_sheet",
        "committed",
        "funded",
        "withdrawn"
      ]
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "default": 50
    }
  }
}