Grails API Documentation

GET /api/v1/charts/listings

Listings created per time bucket with Grails/OpenSea source breakdown.

Authentication: None

Cache: None

Query Parameters

Parameter	Type	Default	Description
`period`	string	`7d`	`1d`, `7d`, `30d`, `1y`, `all`
`club`	string	—	Filter by club (comma-separated for multiple, e.g. `999,10k`)

Sample Request


curl "https://api.grails.app/api/v1/charts/listings?period=30d&club=999,10k"

Response


// 200 OK
{
  "success": true,
  "data": {
    "period": "30d",
    "club": "999,10k",
    "clubs": ["999", "10k"],
    "points": [
      { "date": "2026-03-09T00:00:00.000Z", "total": 12, "grails": 8, "opensea": 4 },
      { "date": "2026-03-10T00:00:00.000Z", "total": 3, "grails": 2, "opensea": 1 }
    ]
  },
  "meta": {
    "timestamp": "2026-04-09T00:00:00.000Z",
    "version": "1.0.0"
  }
}