REST API Reference

Complete documentation for the Coinibi API endpoints.

No authentication required: The Coinibi API is public and does not require API keys. Rate limits apply per IP address (60 req/min).

GET/api/tokens

List tokens across all chains or filter by a specific chain. Returns paginated results with token metadata and safety scores.

Query Parameters

Name	Type	Required	Description
chain	string	No	Filter by blockchain (e.g., "ethereum")
limit	integer	No	Results per page. Default: 50, Max: 500
offset	integer	No	Pagination offset. Default: 0

Example Request

GET /api/tokens?chain=ethereum&limit=10&offset=0

Example Response

{
  "success": true,
  "data": {
    "tokens": [
      {
        "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "name": "Tether USD",
        "symbol": "USDT",
        "chain": "ethereum",
        "decimals": 6,
        "price": 1.00,
        "volume24h": 42500000000,
        "liquidity": 5200000000,
        "marketCap": 118500000000,
        "safetyScore": 95,
        "safetyStatus": "safe"
      }
    ],
    "pagination": {
      "limit": 10,
      "offset": 0,
      "total": 45823
    }
  }
}

GET/api/tokens/{chain}/{address}

Get detailed information about a specific token including price, volume, liquidity, and comprehensive safety analysis.

Path Parameters

Name	Type	Description
chain	string	Blockchain network (e.g., "ethereum", "solana")
address	string	Token contract address

Example Request

GET /api/tokens/ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7

Example Response

{
  "success": true,
  "data": {
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "name": "Tether USD",
    "symbol": "USDT",
    "chain": "ethereum",
    "decimals": 6,
    "price": 1.00,
    "priceChange24h": 0.2,
    "volume24h": 42500000000,
    "volumeChange24h": 5.3,
    "liquidity": 5200000000,
    "marketCap": 118500000000,
    "safetyScore": 95,
    "safetyStatus": "safe",
    "safetyDetails": {
      "liquidityLocked": true,
      "contractVerified": true,
      "mintAuthorityRenounced": true,
      "ownershipRenounced": true,
      "honeypotTest": "pass",
      "topHolderConcentration": 8.5,
      "tradingHistory": "normal",
      "socialPresence": true
    }
  }
}

GET/api/tokens/{chain}/{address}/info

Get token metadata including description, website, social links, and logo URL.

Example Request

GET /api/tokens/ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7/info

Example Response

{
  "success": true,
  "data": {
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "name": "Tether USD",
    "symbol": "USDT",
    "description": "Tether is a stablecoin pegged to the US Dollar",
    "website": "https://tether.to",
    "logoUrl": "https://assets.coinibi.com/logos/usdt.png",
    "social": {
      "twitter": "https://twitter.com/Tether_to",
      "telegram": "https://t.me/tether_news",
      "discord": null,
      "github": null
    }
  }
}

GET/api/tokens/{chain}/{address}/holders

Get holder concentration and distribution data. High concentration in top holders is a red flag for potential rug pulls.

Example Request

GET /api/tokens/ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7/holders

Example Response

{
  "success": true,
  "data": {
    "totalHolders": 2485421,
    "top10Percentage": 8.5,
    "top100Percentage": 22.3,
    "topHolders": [
      {
        "rank": 1,
        "address": "0x1234...",
        "balance": 1500000000,
        "percentage": 1.8
      }
    ]
  }
}

GET/api/tokens/{chain}/{address}/ohlc

Get OHLCV (Open, High, Low, Close, Volume) candle data for price charting.

Query Parameters

Name	Type	Description
interval	string	1m, 5m, 15m, 1h, 4h, 1d (default: 1h)
limit	integer	Number of candles (default: 100, max: 500)

Example Request

GET /api/tokens/ethereum/0xdac17f958d2ee523a2206206994597c13d831ec7/ohlc?interval=1h&limit=24

Example Response

{
  "success": true,
  "data": {
    "candles": [
      {
        "timestamp": 1712880000,
        "open": 0.9998,
        "high": 1.0002,
        "low": 0.9995,
        "close": 1.0001,
        "volume": 2850000000
      }
    ]
  }
}

GET/api/top-movers

Get top gainers and losers across all supported chains in the last 24 hours.

Query Parameters

Name	Type	Description
chain	string	Filter by chain (optional)
limit	integer	Results per category (default: 10, max: 50)

Example Request

GET /api/top-movers?limit=10

Example Response

{
  "success": true,
  "data": {
    "gainers": [
      {
        "address": "0x...",
        "name": "Example Token",
        "symbol": "EXM",
        "chain": "ethereum",
        "price": 0.0542,
        "change24h": 145.3,
        "volume24h": 2500000
      }
    ],
    "losers": [
      {
        "address": "0x...",
        "name": "Falling Token",
        "symbol": "FALL",
        "chain": "solana",
        "price": 0.0012,
        "change24h": -62.1,
        "volume24h": 850000
      }
    ]
  }
}

Error Codes

Code	Message	Description
INVALID_CHAIN	Unsupported blockchain network	The specified chain is not supported
TOKEN_NOT_FOUND	Token not found	The specified token address does not exist
RATE_LIMIT_EXCEEDED	Too many requests	Rate limit (60 req/min) exceeded
INVALID_PARAMETER	Invalid parameter	One or more parameters are invalid
SERVER_ERROR	Internal server error	An unexpected error occurred