GET /coins/{address}/candles

Price candles in USD from every trade on chain, continuous (a quiet interval is flat).

GET https://uprally.co/api/v1/coins/{address}/candles

Parameters

Name	In	Required	Meaning
address	path	yes	The coin’s contract address
tf	query		Default 5m
limit	query		Default 300
to	query		Unix seconds: the last candle; default now

Response

Field	Type	Required	Meaning
token	string	yes	A 0x address, lower case
tf	string	yes
stepSecs	integer	yes
columns	string[]	yes
candles	number[][]	yes
more	boolean	yes
indexedThroughBlock	number or null	yes

A real response

Captured from the live API on Robinhood Chain, exactly as it was sent (long calldata shortened).

{
  "token": "0x39dbed3a2bd333467115de45665cc57f813c4571",
  "tf": "1h",
  "stepSecs": 3600,
  "columns": [
    "time",
    "open",
    "high",
    "low",
    "close",
    "volumeUsd"
  ],
  "candles": [
    [
      1792112400,
      0.3387750243601221,
      0.34404727753270836,
      0.3387750243601221,
      0.34039681822239537,
      850034.295744582
    ],
    [
      1792116000,
      0.34039681822239537,
      0.348267167771383,
      0.3371571645799335,
      0.337528254236828,
      857390.3542841362
    ],
    [
      1792119600,
      0.337528254236828,
      0.3414283410222915,
      0.3365714101879952,
      0.3369495807578557,
      331926.17017810984
    ]
  ],
  "more": true,
  "indexedThroughBlock": 89764062
}

Errors

Every error is { "error": { "code", "message", "fix"? } }. This endpoint can answer:

• INVALID_ADDRESS: A field that must be a 0x address is not one; field says which.
• INVALID_QUERY: A query parameter is out of range or malformed; field says which.
• DATA_UNREACHABLE: The data behind this answer could not be read just now.