Riferimento API

API Overview

Base URL, authentication, rate limits, and the JSON response format for the Cryptohopper.AI REST API.

Ultimo aggiornamento:

Cryptohopper.AI Public API

The Cryptohopper.AI API lets you programmatically create, manage, and deploy projects — trading bots, dashboards, and screeners. It is built for AI agents, CI/CD pipelines, and developers who want to wire Cryptohopper.AI into their own workflows.

Base URL

https://www.cryptohopper.ai/api/v1

All API endpoints are prefixed with /api/v1. The API uses JSON for request and response bodies.

Requirements

  • A Cryptohopper account with an active Hero subscription
  • An account API key (created from Account → API Keys)

See Managing API Keys for how to create and store one.

Quick Start

1. Create an API key from Account → API Keys

2. Make your first API call:

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

3. Create a project:

curl -X POST https://www.cryptohopper.ai/api/v1/projects \
  -H "Authorization: Bearer flp_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "BTC/USDT Grid Bot",
    "subdomain": "btc-grid-bot",
    "prompt": "A BTC/USDT grid trading bot with a live performance dashboard"
  }'

Response Format

All successful responses are wrapped in a data envelope:

{
  "data": {
    "id": "...",
    "name": "BTC/USDT Grid Bot",
    "url": "https://btc-grid-bot.cryptohopper.app",
    ...
  }
}

Error responses use an error envelope:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: name, subdomain, prompt"
  }
}

For authentication details see Authentication; for the full error reference see Error Handling.

PrecedenteChiavi API e segretiSuccessivoAuthentication