Quickstart

Get from zero to your first AIXBT API call in under 5 minutes.

Prerequisites

An AIXBT account (create one by signing in with your web3 wallet)
curl or a programming language with HTTP support

Get Your API Key

Sign in at aixbt.tech with your web3 wallet
Go to Settings → API Keys
Create your API key

Anyone who has signed in with their wallet can create a free demo key. Demo keys work with all non-agentic endpoints but only return data for Bitcoin. This lets you build and test your integration before upgrading to a data plan.

Full-Access Key

Users on a Data Plan can create a full-access key from the same location. This provides access to all projects and the complete dataset.

Keep your API key secure. Don't commit it to version control or expose it in client-side code.

Make Your First Request

Let's fetch the list of projects with the highest momentum scores.

Using a demo key? Your response will only include Bitcoin data. The same code works with a full-access key to access all projects.

Using curl

curl -X GET "https://api.aixbt.tech/v2/projects?limit=5" \
  -H "x-api-key: YOUR_API_KEY"

Using JavaScript

const response = await fetch('https://api.aixbt.tech/v2/projects?limit=5', {
  headers: {
    'x-api-key': process.env.AIXBT_API_KEY,
  },
})

const { data } = await response.json()
console.log(data)

Using Python

import requests

response = requests.get(
    'https://api.aixbt.tech/v2/projects',
    params={'limit': 5},
    headers={'x-api-key': 'YOUR_API_KEY'}
)

data = response.json()['data']
print(data)

Understanding the Response

A successful request returns a JSON object with project data:

{
  "status": 200,
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "ethereum",
      "xHandle": "ethereum",
      "momentumScore": 0.85,
      "popularityScore": 18,
      "signals": [...],
      "coingeckoData": {...}
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 5,
    "totalCount": 1000,
    "hasMore": true
  }
}

Key fields:

momentumScore - Rate of spread to new communities (typically 0-1, unbounded)
popularityScore - Hours with mentions in the last 24h (0-24)
signals - Recent events and developments for the project

Alternative: Pay-Per-Request with x402

Don't want to manage API keys? Use the x402 protocol to pay per request directly with your wallet. No registration required.

Next Steps

REST API - Authentication details and rate limits
x402 - Pay-per-request integration
API Reference - Complete endpoint documentation

Common Use Cases

Get signals for a specific project: GET /v2/projects/{id}
Get top 10 surging projects: GET /v2/projects?limit=10
Track momentum over time: GET /v2/projects/{id}/momentum
Filter signals by category: GET /v2/signals?categories=TECH_EVENT,PARTNERSHIP