API guide

Gopher API Guide

Welcome to the Gopher API. This guide explains how to request API access, make authenticated calls, and interpret JSON responses.

Request an API Key

To begin using the Gopher API, request an API key from the Gopher team.

How to Request

Fill out the API Key Request Form to request access.The team will review your request and send you an API key.

Making API Requests

All requests require an X-API-Key header.

cURL Request Template

curl -H "X-API-Key: <API_KEY>" \
"https://<GOPHER_URL>/api/market-data/candles?symbol=<EXCHANGE:ASSET_PAIR>&timeframe=<TIMEFRAME>&limit=<ROWS>"

Parameters

Field	Description	Example
symbol	Exchange + asset pair	BINANCE:BTCUSDT
timeframe	Candle interval	15m, 1h, 1d
limit	Number of rows (1-1000)	100

Supported Exchanges

✅ BINANCE
✅ COINBASE

Supported Timeframes

Only the following timeframes are accepted:1m, 5m, 15m, 1h, 4h, 1d

Row Limit

Maximum: 1000
Requests above this return an error.

Example Error Response

{"status":"error","error":{"code":"INVALID_LIMIT","message":"Limit must be between 1 and 1000"}}

Understanding the JSON Response

Example Response

{
  "status": "success",
  "data": {
    "symbol": "COINBASE:ETHUSDT",
    "timeframe": "4h",
    "count": 1,
    "candles": [
      {
        "timestamp": 1762329600,
        "open": 3331.06,
        "high": 3331.06,
        "low": 3282.84,
        "close": 3295.26,
        "volume": 1201.34418178
      }
    ]
  }
}

Response Fields

Field	Meaning
status	success/error
symbol	Exchange + pair
timeframe	Candle timeframe
count	Total rows returned
candles[]	OHLCV objects + timestamp

Example API Calls

Below are example calls using the development environment:

Binance — 15m, 100 candles

curl -H "X-API-Key: <API_KEY>" \
"https://gotrader.gopher-ai.com/api/market-data/candles?symbol=BINANCE:BTCUSDT&timeframe=15m&limit=100"

Binance — 1h, 10 candles

curl -H "X-API-Key: <API_KEY>" \
"https://gotrader.gopher-ai.com/api/market-data/candles?symbol=BINANCE:BTCUSDT&timeframe=1h&limit=10"

Coinbase — 4h, 20 candles

curl -H "X-API-Key: <API_KEY>" \
"https://gotrader.gopher-ai.com/api/market-data/candles?symbol=COINBASE:ETHUSDT&timeframe=4h&limit=20"

GoTrader API

Gopher API Guide

How to Request

cURL Request Template

Parameters

Supported Exchanges

Supported Timeframes

Row Limit

Example Error Response

Example Response

Response Fields

Example API Calls

Binance — 15m, 100 candles

Binance — 1h, 10 candles

Coinbase — 4h, 20 candles

Summary

​Gopher API Guide

​How to Request

​cURL Request Template

​Parameters

​Supported Exchanges

​Supported Timeframes

​Row Limit

​Example Error Response

​Example Response

​Response Fields

​Example API Calls

​Binance — 15m, 100 candles

​Binance — 1h, 10 candles

​Coinbase — 4h, 20 candles

​Summary

Gopher API Guide

How to Request

cURL Request Template

Parameters

Supported Exchanges

Supported Timeframes

Row Limit

Example Error Response

Example Response

Response Fields

Example API Calls

Binance — 15m, 100 candles

Binance — 1h, 10 candles

Coinbase — 4h, 20 candles

Summary