Skip to main content
GET
/
v0
/
markets
/
history
Get historical market snapshots
curl --request GET \
  --url https://markets.dial.to/api/v0/markets/history \
  --header 'x-dialect-client-key: <api-key>'
{
  "data": {
    "markets": [
      {
        "id": "<string>",
        "history": [
          {
            "timestamp": "2023-11-07T05:31:56Z",
            "depositApy": 123,
            "totalDeposit": 123,
            "totalDepositUsd": 123
          }
        ]
      }
    ]
  }
}

Authorizations

x-dialect-client-key
string
header
default:pk_demo
required

Client key for the Markets API

Query Parameters

marketIds
string
required

Comma separated list of market IDs.

startTime
string<date-time>
default:2025-06-01T00:00:00Z
required

Start time of the snapshot. Date or datetime in RFC 3339 format

Example:

"2025-06-01T00:00:00Z"

endTime
string<date-time>
default:2025-10-09T23:59:59Z

End time of the snapshot. Date or datetime in RFC 3339 format. Defaults to current time if not provided

Example:

"2025-10-09T23:59:59Z"

resolution
enum<string>

Time interval for historical snapshots. Controls the granularity of data points returned.

Available options:
1h,
1d

Response

200 - application/json

OK

data
object
required