Market Data API — Prices, Charts, and Token Info

GET /market-data endpoints return real-time token prices, OHLCV candlestick chart data, and trending tokens across all supported networks.

The Market Data API provides real-time and historical price information for any token tracked by Big Brain Ape. You can fetch a token’s current price, pull OHLCV candlestick data for charting, or surface trending tokens across supported networks — all from a single, consistent interface.

Basic price data (GET /market-data) does not require authentication. Extended fields such as on-chain volume breakdowns, holder analytics, and whale activity require a valid Bearer token with the read scope.

---

GET /market-data

Fetch the current price and 24-hour market statistics for a specific token. This endpoint is publicly accessible for basic price data; pass your Bearer token to unlock extended market metrics.

Query Parameters

token · string · required

The token to look up. Accepts a ticker symbol (e.g. SOL) or a full contract address.

network · string

Restrict the lookup to a specific network. Accepted values: solana, ethereum, base, arbitrum. Useful when a token exists on multiple chains.

currency · string · default: "USD"

The fiat currency used for price and market cap values. Defaults to USD.

Example Request

curl 'https://api.bigbrainape.com/v1/market-data?token=SOL&currency=USD'

Example Response

{
  "success": true,
  "data": {
    "token": "SOL",
    "price": 144.32,
    "currency": "USD",
    "change24h": 5.21,
    "volume24h": 1234567890,
    "marketCap": 68000000000
  },
  "timestamp": "2024-01-15T14:32:00Z"
}

Response Fields

data.token · string

The ticker symbol of the requested token.

data.price · number

The current market price expressed in the requested currency.

data.currency · string

The currency code used for all monetary values in this response.

data.change24h · number

Percentage price change over the past 24 hours. Negative values indicate a price decrease.

data.volume24h · number

Total trading volume over the past 24 hours, in the requested currency.

data.marketCap · number

Current market capitalisation of the token, in the requested currency.

---

GET /market-data/chart

Retrieve OHLCV (Open, High, Low, Close, Volume) candlestick data for a token over a specified time range. Use this endpoint to power trading charts or backtest strategies.

Required scope: read

Query Parameters

token · string · required

The token to retrieve chart data for. Accepts a ticker symbol or contract address.

timeframe · string · required

The duration of each candle. Accepted values: 1m, 5m, 15m, 1h, 4h, 1d.

from · string

Start of the time range as an ISO 8601 UTC timestamp (e.g. 2024-01-01T00:00:00Z). Defaults to 24 hours before to.

to · string

End of the time range as an ISO 8601 UTC timestamp. Defaults to the current time.

network · string

Restrict data to a specific network. Accepted values: solana, ethereum, base, arbitrum.

Example Request

curl 'https://api.bigbrainape.com/v1/market-data/chart?token=SOL&timeframe=1h&from=2024-01-15T00:00:00Z&to=2024-01-15T06:00:00Z' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "success": true,
  "data": {
    "token": "SOL",
    "timeframe": "1h",
    "currency": "USD",
    "candles": [
      {
        "timestamp": "2024-01-15T00:00:00Z",
        "open": 138.20,
        "high": 140.55,
        "low": 137.80,
        "close": 139.90,
        "volume": 82340500
      },
      {
        "timestamp": "2024-01-15T01:00:00Z",
        "open": 139.90,
        "high": 143.10,
        "low": 139.50,
        "close": 142.45,
        "volume": 94120300
      },
      {
        "timestamp": "2024-01-15T02:00:00Z",
        "open": 142.45,
        "high": 145.00,
        "low": 141.80,
        "close": 144.32,
        "volume": 110875000
      }
    ]
  },
  "timestamp": "2024-01-15T14:32:00Z"
}

Response Fields

data.token · string

The ticker symbol of the token this chart data belongs to.

data.timeframe · string

The candle duration used in this response.

data.currency · string

The currency used for all price and volume values.

data.candles · array

Ordered list of OHLCV candles, from oldest to newest.

Show candle item fields

timestamp · string

ISO 8601 UTC timestamp marking the open of this candle.

open · number

Token price at the start of the candle period.

high · number

Highest price reached during the candle period.

low · number

Lowest price reached during the candle period.

close · number

Token price at the end of the candle period.

volume · number

Total trading volume during the candle period, in the requested currency.

For live charting, request the most recent candles by omitting from and to and polling at the same interval as your chosen timeframe.

---

GET /market-data/trending

Retrieve the most-talked-about and highest-momentum tokens across Big Brain Ape’s tracked networks. Use this endpoint to surface breakout tokens, populate a trending feed, or feed discovery features in your application.

Query Parameters

network · string

Filter trending tokens to a specific network. Accepted values: solana, ethereum, base, arbitrum. Omit to return trending tokens from all networks.

limit · number · default: "10"

Number of trending tokens to return. Defaults to 10, maximum 50.

Example Request

curl 'https://api.bigbrainape.com/v1/market-data/trending?network=solana&limit=5' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Example Response

{
  "success": true,
  "data": {
    "network": "solana",
    "updatedAt": "2024-01-15T14:00:00Z",
    "tokens": [
      {
        "rank": 1,
        "token": "BONK",
        "price": 0.0000142,
        "change24h": 38.50,
        "volume24h": 520000000,
        "network": "solana"
      },
      {
        "rank": 2,
        "token": "JTO",
        "price": 3.84,
        "change24h": 14.20,
        "volume24h": 210000000,
        "network": "solana"
      },
      {
        "rank": 3,
        "token": "PYTH",
        "price": 0.61,
        "change24h": 9.80,
        "volume24h": 95000000,
        "network": "solana"
      }
    ]
  },
  "timestamp": "2024-01-15T14:32:00Z"
}

Response Fields

data.network · string

The network filter applied to this trending list, or all if no network was specified.

data.updatedAt · string

ISO 8601 UTC timestamp indicating when the trending rankings were last recalculated.

data.tokens · array

Ordered list of trending tokens, from highest-ranked to lowest.

Show token item fields

rank · number

The token’s position in the trending list, starting at 1.

token · string

The ticker symbol of the trending token.

price · number

Current market price in USD.

change24h · number

Percentage price change over the past 24 hours.

volume24h · number

Total 24-hour trading volume in USD.

network · string

The network on which this token is primarily traded.