---
title: "Wallet release timeline"
method: GET
path: "/api/v1/wallets/timeline"
tags: ["Wallets"]
---

# Wallet release timeline

`GET /api/v1/wallets/timeline`

The wallet list pinned to `released_at` descending (undated wallets last). Same
row shape and pagination envelope as `List wallets`.

## Query parameters

- `page` integer, nullable — Page number (1-based). Must be at least 1.
- `per_page` integer, nullable — Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.
- `search` string, nullable — Free-text match on wallet name. Must not be greater than 100 characters.
- `min_score` integer, nullable — Only wallets with a review score at or above this value. Must be at least 0.
- `max_score` integer, nullable — Only wallets with a review score at or below this value. Must be at least 0.
- `tags` string, nullable — Filter by tag taxonomy: comma-separated category-group ids (the same ids the web facet filters submit). Must not be greater than 1000 characters.
- `ids` string, nullable — Filter to specific wallet ids (CSV, up to 100). Must not be greater than 1000 characters.
- `slugs` string, nullable — Filter to specific wallet slugs (CSV, up to 100). Must not be greater than 2000 characters.
- `sort` string, nullable — Comma-separated sort fields; prefix with - for descending. Sortable: score, released_at, assets, pros, cons. Must not be greater than 100 characters.

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)