ChipaTrade
Sign InCreate Account

API Reference

Welcome to the chipa.trade API documentation. Our API provides programmatic access to trading data, token information, and platform features. All API endpoints require authentication using API keys.

Authentication & API Keys

All protected endpoints require an API key. You can manage your API keys in your account dashboard.

Getting API Keys

  1. Sign in to your chipa.trade account
  2. Navigate to Account Settings → API Keys
  3. Click "Create New API Key"
  4. Set permissions and rate limits
  5. Copy and securely store your API key

Request Header

curl -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://chipa.trade/api/endpoint

Rate Limits

  • • Default: 60 requests per minute
  • • Premium: 300 requests per minute
  • • Enterprise: Custom limits available

API Endpoints

GET /api/new-pairs

Protected

Discover newly listed trading pairs from Raydium and Pump.fun.

Query Parameters

  • hours (number, optional) - Timeframe in hours (1-168). Default: 24
  • source (string, optional) - Filter by source: raydium, pump.fun, or all. Default: all

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
     "https://chipa.trade/api/new-pairs?hours=24&source=raydium"

Example Response

{
  "pairs": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Solana",
      "source": "raydium",
      "poolId": "58oQChx4yWmvKdwLLZzBi4ChoCc2fqCUWBkwMihLYQo2",
      "createdAt": "2025-06-17T10:30:00Z",
      "liquidity": 125000.50,
      "price": 150.25
    }
  ],
  "stats": {
    "total": 1,
    "timeframe": "24 hours",
    "sources": {
      "pump.fun": 0,
      "raydium": 1
    }
  }
}

POST /api/market-data

Protected

Get detailed market data for multiple tokens.

Request Body

{
  "tokens": ["So11111111111111111111111111111111111111112"],
  "timeframe": "5m",
  "limit": 100
}

Example Request

curl -X POST \
     -H "x-api-key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"tokens":["So11111111111111111111111111111111111111112"],"timeframe":"5m"}' \
     "https://chipa.trade/api/market-data"

GET /api/price/[mint]

Protected

Get real-time price data for a specific token.

Path Parameters

  • mint (string, required) - Token mint address

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
     "https://chipa.trade/api/price/So11111111111111111111111111111111111111112"

GET /api/status

Public

Get real-time system status and service health.

Example Request

curl "https://chipa.trade/api/status"

Error Codes

Client Errors (4xx)

  • 400 - Bad Request
  • 401 - Unauthorized (Invalid API Key)
  • 403 - Forbidden
  • 404 - Not Found
  • 429 - Rate Limit Exceeded

Server Errors (5xx)

  • 500 - Internal Server Error
  • 502 - Bad Gateway
  • 503 - Service Unavailable
  • 504 - Gateway Timeout

Rate Limit Headers

All API responses include rate limit headers:

  • X-RateLimit-Limit - Maximum requests per minute
  • X-RateLimit-Remaining - Remaining requests in current window
  • X-RateLimit-Reset - Time when rate limit resets (Unix timestamp)

SDKs & Examples

JavaScript/TypeScript

npm install @chipa-trade/sdk
import { ChipaAPI } from '@chipa-trade/sdk';

const api = new ChipaAPI('your-api-key');
const pairs = await api.getNewPairs();

Python

pip install chipa-trade
import chipa_trade

client = chipa_trade.Client('your-api-key')
pairs = client.get_new_pairs()