# List coins

> Payday coins on every chain, newest first by default. Filter by chain, status, account, pairing or basket, and sort by market cap, volume or holders.


`GET https://payday.direct/api/v1/coins`

Payday coins on every chain, newest first by default. Filter by chain, status, account, pairing or basket, and sort by market cap, volume or holders.

## Parameters

- `limit` (query, integer)
- `cursor` (query, string): next_cursor from the previous page
- `status` (query, "curve" | "graduated")
- `handle` (query, string): X handle the coin pays
- `pair` (query, "sol" | "stock")
- `basket` (query, "any" | "payout" | "fund"): basket coins only: any (mixed included) or one type; each coin carries cash_payback.basket { type, icon, legs, payback, rules }
- `chain` (query, "solana" | "elysium")
- `since` (query, string): created after
- `sort` (query, "new" | "market_cap" | "volume" | "holders")

## Responses

- 200: OK
- 401: Missing or invalid key
- 429: Over the limit. Retry-After says when to try again.

```json
{
  "data": [
    {
      "mint": "3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
      "symbol": "Example",
      "name": "Example Coin",
      "image": "https://payday.direct/img/example.png",
      "created_at": "2026-11-14T18:02:11.000Z",
      "status": "curve",
      "curve_progress_bps": 6423,
      "quote": {
        "mint": "So11111111111111111111111111111111111111112",
        "symbol": "SOL"
      },
      "market": {
        "market_cap_usd": "11282.45",
        "volume_24h_usd": "102734.54",
        "liquidity_usd": "3019.00",
        "holders": 164,
        "price_change_24h_pct": 244.5,
        "last_trade_at": "2026-11-15T19:35:36.000Z"
      },
      "recipient": {
        "rail": "xmoney",
        "handle": "examplehandle"
      },
      "mode": "account",
      "cash_payback": null,
      "dex": {
        "status": "filling",
        "reserved_usd": "199.55",
        "target_usd": "299.00",
        "sent_tx": null,
        "sent_at": null
      },
      "chain": "solana",
      "chain_id": null,
      "links": {
        "page": "https://payday.direct/explore#coin/3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
        "pump": "https://pump.fun/coin/3unDHbPUsLqQtoHgvuCsRSArnuhVjhsn11vRht5Xpump",
        "website": null,
        "x": "https://x.com/examplehandle",
        "telegram": null
      }
    }
  ],
  "next_cursor": "MQ",
  "total": 412,
  "meta": {
    "updated_at": "2026-11-15T20:03:20.991Z",
    "api_version": "v1"
  }
}
```

## Example

```bash
curl "https://payday.direct/api/v1/coins" \
  -H "Authorization: Bearer pd_YOUR_KEY"
```