Projects

Projects API

Manage your Cryptohopper.AI projects programmatically.

List Projects

GET /api/v1/projects

Returns all projects owned by the authenticated user.

curl -X GET https://www.cryptohopper.ai/api/v1/projects \
  -H "Authorization: Bearer flp_your_key"

Each project includes a url field with its live address, for example https://btc-grid-bot.cryptohopper.app.

Create Project

POST /api/v1/projects

Creates a new project and starts the AI generation pipeline.

Request Body:

{
  "name": "BTC/USDT Grid Bot",   // required
  "subdomain": "btc-grid-bot",   // required, lowercase
  "prompt": "Description...",     // required
  "isAuthProtected": true         // optional, default true
}

Response (201):

{
  "data": {
    "project": {
      "id": "...",
      "name": "BTC/USDT Grid Bot",
      "status": "queued",
      "url": "https://btc-grid-bot.cryptohopper.app",
      ...
    },
    "deployment": { "id": "...", "version": 1, "status": "pending" }
  }
}

Get Project

GET /api/v1/projects/{projectId}

Returns details of a specific project, including its url on cryptohopper.app once deployed.

Update Project

PATCH /api/v1/projects/{projectId}

Request Body (all fields optional):

{
  "name": "New Name",
  "description": "Updated description",
  "isPublic": true,
  "isAuthProtected": false
}

Archive Project

DELETE /api/v1/projects/{projectId}

Archives a project and releases its cryptohopper.app subdomain. Hosting resources are cleaned up in the background.

Deploying & secrets

To build, redeploy, and check the status of a project see Deployment API. To manage the credentials a project reads at runtime — such as exchange API keys — see Secrets API.