Chain history

GET https://open-api.coinworldcap.com/openapi/v1/chains/history

One chain's total market cap and 24-hour volume over time, by day or by hour — the history of /chains' market figures.

Query parameters

idintegerDefaultrequiredThe chain's id from /chains
interval, time_start, time_endstringDefault1d, none, nowSee History: what the endpoints share

Response

Fields

Field	Type	Notes
`id`, `interval`	number, string	What you asked for
`points[].time`	string	RFC3339 UTC: the start of the hour, or midnight for a day
`points[].market_cap`, `points[].volume_24h`	string	USD, never `null`

Each point is the last figure we recorded in its hour or day, from the same records as /chains. /chains' coins_count and market_cap_share have no history. New points arrive every hour, and the newest ones can still be revised for a while after; today's daily point appears once the day is over. How far back a chain goes depends on when we started recording it (Data methodology).

Examples

bash

# A chain's daily market cap and volume since 1 October
curl -H "X-Api-Key: <your-api-key>" \
  "https://open-api.coinworldcap.com/openapi/v1/chains/history?id=126&time_start=2026-10-01T00:00:00Z"

HTTP status	`code`	When
400	40000	`id` missing or not a positive integer; a parameter the shared history rules refuse
404	40400	No chain with that `id`, or one we have disabled. A chain that exists without any history answers `200` with `points: []`

The other errors are in Errors.

# A chain's daily market cap and volume since 1 October import requests response = requests.get( "https://open-api.coinworldcap.com/openapi/v1/chains/history?id=126&time_start=2026-10-01T00:00:00Z", headers={"X-Api-Key": "<your-api-key>"}, ) print(response.json())

// A chain's daily market cap and volume since 1 October fetch("https://open-api.coinworldcap.com/openapi/v1/chains/history?id=126&time_start=2026-10-01T00:00:00Z", { headers: { "X-Api-Key": "<your-api-key>" }, }) .then((response) => response.json()) .then((body) => console.log(body));

// A chain's daily market cap and volume since 1 October package main import ( "fmt" "io" "net/http" ) func main() { req, err := http.NewRequest(http.MethodGet, "https://open-api.coinworldcap.com/openapi/v1/chains/history?id=126&time_start=2026-10-01T00:00:00Z", nil) if err != nil { panic(err) } req.Header.Set("X-Api-Key", "<your-api-key>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

// A chain's daily market cap and volume since 1 October import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder(URI.create("https://open-api.coinworldcap.com/openapi/v1/chains/history?id=126&time_start=2026-10-01T00:00:00Z")) .header("X-Api-Key", "<your-api-key>") .GET() .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

{ "code": 0, "message": "success", "message_key": "SUCCESS", "result": { "id": 126, "interval": "1d", "points": [ { "time": "2026-10-19T00:00:00Z", "market_cap": "401234567890.12", "volume_24h": "21345678901.5" } ] } }