Integration and API

Seamless connectivity solutions enabling powerful blockchain integrations.

API Documentation

Token Metrics Endpoint

GET /v1/metrics/{token}

Retrieves comprehensive token metrics including price, volume, and market data.

Base URL

https://api.kirokugo.com

Path Parameters

Parameter	Type	Required	Description
token	string	Yes	Token identifier (KIRO or KUGO)

Query Parameters

Parameter	Type	Required	Default	Description
timeframe	string	No	"24h"	Time period for data (1h, 24h, 7d, 30d)

Response

{
    "price": "0.0001982",
    "volume24h": "90991",
    "marketCap": "817400",
    "holders": 740,
    "timestamp": "2024-11-11T12:00:00Z"
}

Response Fields

Field	Type	Description
price	string	Current token price in USD
volume24h	string	24-hour trading volume in USD
marketCap	string	Current market capitalization in USD
holders	number	Total number of token holders
timestamp	string	UTC timestamp of the data

Example Request

curl -X GET "https://api.kirokugo.com/v1/metrics/KUGO?timeframe=24h" \
  -H "accept: application/json"

Status Codes

Code	Description
200	Successful response
400	Bad request - Invalid parameters
404	Token not found
429	Rate limit exceeded
500	Internal server error

---

Historical Data Endpoint

GET /v1/historical/{token}

Retrieves historical price and volume data for specified time periods.

Path Parameters

Parameter	Type	Required	Description
token	string	Yes	Token identifier (KIRO or KUGO)

Query Parameters

Parameter	Type	Required	Default	Description
start	string	No	-7d	Start date (ISO 8601)
end	string	No	now	End date (ISO 8601)
interval	string	No	"1h"	Data interval (1m, 5m, 1h, 1d)

Response

{
    "data": [
        {
            "timestamp": "2024-11-11T00:00:00Z",
            "price": "0.12345",
            "volume": "123456",
            "marketCap": "1234567"
        }
        // Additional data points...
    ],
    "metadata": {
        "token": "KUGO",
        "interval": "1h",
        "dataPoints": 168
    }
}

---

Holder Statistics Endpoint

GET /v1/holders/{token}

Retrieves detailed holder statistics and distribution data.

Path Parameters

Parameter	Type	Required	Description
token	string	Yes	Token identifier (KIRO or KUGO)

Response

{
    "totalHolders": 22259,
    "distribution": {
        "top10": 45.5,
        "top50": 67.8,
        "top100": 78.9
    },
    "holdingRanges": [
        {
            "range": "1-1000",
            "holders": 15234,
            "percentage": 68.44
        }
        // Additional ranges...
    ]
}

---

Rate Limits

Plan	Requests/Minute	Daily Limit
Public	60	5,000
Premium	300	50,000
Enterprise	Unlimited	Unlimited

All API endpoints require authentication via API key in the request header:

X-API-Key: your_api_key_here