For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integration Guide

Butter API for Data provides developers with basic data.

Base URL

https://butterapi.chainservice.io

API Interface Overview

Interface
Description

Query dashboard analytics by time range.

Query the supported token list, optionally filtered by chain.

Query a single token by address or symbol.

Authentication

Analytics endpoints require signed requests.

Each request must include these headers:

Header
Value
Description

BS-ACCESS-KEY

<your-api-key>

API key issued by Butter Network.

BS-ACCESS-SIGN

<signature>

Base64 HMAC-SHA256 signature.

BS-ACCESS-TIMESTAMP

<timestamp>

ISO 8601 UTC timestamp, for example 2026-07-23T08:00:00.000Z. It must be within 30 seconds of server time.

BS-ACCESS-PASSPHRASE

<your-passphrase>

Passphrase paired with the API key.

Signature formula:

BS-ACCESS-SIGN = Base64(HMAC-SHA256(secretKey, timestamp + method + requestPath + body))
Part
Description

timestamp

Same value as BS-ACCESS-TIMESTAMP.

method

HTTP method in uppercase, such as GET.

requestPath

Path plus query string, such as /api/statistics/dashboard?unit=30d&start=1784772000000.

body

Raw request body. GET requests use an empty string.

Query parameters are part of requestPath, not body.

Signing Example

For endpoint parameters and response fields, see GET Dashboard By Unit, GET Token List, and GET Token Detail.

Error Response

Code
Description

50100

Missing signature headers.

50101

Invalid API key.

50102

Timestamp is invalid or outside the allowed time window.

50103

Invalid signature.

50104

Invalid passphrase.

50105

API key is disabled.

50106

API key is expired.

50107

Rate limit exceeded.

Last updated