DEVELOPER PLATFORM · VERSION 1.0

BANG BNG Public API

Use the public API to retrieve service status, privacy-safe aggregate statistics and supported market prices and BNG platform pricing. The initial release is read-only and requires no API key for GET requests.

Base URL: https://1bang.top/api/v1Download OpenAPI 3.1 JSON

Getting started

Send HTTPS GET requests to an endpoint below. Responses use JSON. No sign-in or API key is required for these public read-only endpoints.

curl -sS https://1bang.top/api/v1/status

For production integrations, cache responses where appropriate, use reasonable request intervals, and handle non-200 responses.

Available endpoints

GET/status

Returns the service status response.

curl -sS https://1bang.top/api/v1/status

GET/health

Alias for the status endpoint.


GET/stats

Returns aggregate visitor, active-session and connection counts. It does not return account IDs, email addresses or IP addresses.

curl -sS https://1bang.top/api/v1/stats

GET/market?pair=BNGUSDT

Returns the current price information for one supported pair.

PairMeaning
BNGUSDTBNG / USDT price
BNGBNBBNG / BNB price
BTCUSDTBTC / USDT market data
BNBUSDTBNB / USDT market data
curl -sS "https://1bang.top/api/v1/market?pair=BNGUSDT"

JavaScript example

const response = await fetch( "https://1bang.top/api/v1/market?pair=BNGUSDT" ); if (!response.ok) { throw new Error(`API request failed: ${response.status}`); } const market = await response.json(); if (market.simulated) { console.warn("Illustrative price only:", market.notice); } else { console.log("Market price:", market.priceUsd); }

Response fields and errors

Successful responses include apiVersion, ok and endpoint-specific fields. Market responses may include priceUsd, priceChange24h, volume24h, liquidityUsd, updatedAt, and market-provider metadata.

HTTP statusMeaning
200Request completed.
400Unsupported query value.
404Endpoint or verified market not found.
405Method not allowed. This API is read-only.
502 / 503Upstream market provider or service temporarily unavailable.

Important data and security notes

BNG price: BNG values returned by this endpoint follow the BANG BNG 90-day price schedule. They are not an independently traded exchange price, proof of liquidity or guaranteed redemption value. The API includes a price-type field so applications can identify the schedule.

OpenAPI specification

Import this machine-readable OpenAPI 3.1 document into Swagger UI, Postman or another compatible API client.