> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payment Card Accounts

> Activity of crypto card programs on each chain: accounts created, activated and active, spenders (daily, 7-day and 30-day, new and returning), spend in USD split by new, returning and top spenders, refunds, cashback, deposits and withdrawals, holders by balance size, balances held and 7-day and 30-day spender churn. Each series is one card program on one chain.

One row per payment card account, keyed by protocol, chain and card program: the parent protocol and product, chain, token and the mapped protocol, project and network records. The id is the series key of the payment-card-accounts timeseries model.

| | |
| - | - |
| Access | Lending-protocols-dataset |
| Tabular model | `payment-card-accounts`: primary key `id` |
| Timeseries model | `payment-card-accounts`: intervals `1d`, series key `id` (Payment Card Account ID), series must be named (up to 10 per call) |

## Endpoints

> [card] [List Payment Card Accounts](https://docs.blockworks.com/api-reference/data-api/payment-cards/tabular-payment-card-accounts.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get Payment Card Account timeseries](https://docs.blockworks.com/api-reference/data-api/payment-cards/timeseries-payment-card-accounts.md)
>
> Up to 10 series in one request, named by Payment Card Account ID in `series`.

> [card] [Get Payment Card Account timeseries](https://docs.blockworks.com/api-reference/data-api/payment-cards/timeseries-payment-card-accounts-by-id.md)
>
> One series over a time window, keyed by its Payment Card Account ID.

## Metrics

36 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `accountsCreated` | Accounts Created | float64 | | Card accounts created that day. |
| `activeAccounts` | Active Accounts | float64 | | Card accounts active that day. |
| `accountsActivated` | Accounts Activated | float64 | | Card accounts activated that day. |
| `uniqueSpenders` | Unique Spenders | float64 | | Distinct accounts that spent that day. |
| `newSpenders` | New Spenders | float64 | | Accounts whose first spend was that day. |
| `uniqueSpenders7D` | Unique Spenders (7D) | float64 | | Distinct spenders over the 7 days ending that day. |
| `uniqueSpenders30D` | Unique Spenders (30D) | float64 | | Distinct spenders over the 30 days ending that day. |
| `activeAccounts7D` | Active Accounts (7D) | float64 | | Distinct active accounts over the 7 days ending that day. |
| `activeAccounts30D` | Active Accounts (30D) | float64 | | Distinct active accounts over the 30 days ending that day. |
| `spendUSD` | Spend (USD) | float64 | | Card spend in USD. |
| `spendNewUSD` | New Spender Spend (USD) | float64 | | Spend by new spenders in USD. |
| `spendReturningUSD` | Returning Spender Spend (USD) | float64 | | Spend by returning spenders in USD. |
| `medianSpendUSD` | Median Spend (USD) | float64 | | Median spend in USD. |
| `spendTop1PctUSD` | Top 1% Spend (USD) | float64 | | Spend of the top 1% of spenders that day in USD. |
| `spendTop10PctUSD` | Top 10% Spend (USD) | float64 | | Spend of the top 10% of spenders that day in USD (includes the top 1%). |
| `spendTop1Pct7DUSD` | Top 1% Spend (7D, USD) | float64 | | Spend of the top 1% of spenders over 7 days in USD. |
| `spendTop10Pct7DUSD` | Top 10% Spend (7D, USD) | float64 | | Spend of the top 10% of spenders over 7 days in USD. |
| `spendTop1Pct30DUSD` | Top 1% Spend (30D, USD) | float64 | | Spend of the top 1% of spenders over 30 days in USD. |
| `spendTop10Pct30DUSD` | Top 10% Spend (30D, USD) | float64 | | Spend of the top 10% of spenders over 30 days in USD. |
| `refundUSD` | Refunds (USD) | float64 | | Refunds in USD. |
| `cashbackUSD` | Cashback (USD) | float64 | | Cashback paid in USD. |
| `depositUSD` | Deposits (USD) | float64 | | Deposits into card accounts in USD. |
| `withdrawalUSD` | Withdrawals (USD) | float64 | | Withdrawals from card accounts in USD. |
| `holders` | Holders | float64 | | Accounts holding \$1 or more. |
| `holdersOver100USD` | Holders (\$100+) | float64 | | Accounts holding \$100 or more across tokens. |
| `holdersOver1kUSD` | Holders (\$1k+) | float64 | | Accounts holding \$1,000 or more across tokens. |
| `holdersOver10kUSD` | Holders (\$10k+) | float64 | | Accounts holding \$10,000 or more across tokens. |
| `totalBalanceUSD` | Total Balance (USD) | float64 | | Balance held in card accounts in USD (holder subtypes only). |
| `avgBalanceUSD` | Average Balance (USD) | float64 | | Average balance per holder in USD. |
| `medianBalanceUSD` | Median Balance (USD) | float64 | | Median balance per holder in USD. |
| `returningSpenders7D` | Returning Spenders (7D) | float64 | | Spenders in the 7-day window whose first spend came before it. |
| `returningSpenders30D` | Returning Spenders (30D) | float64 | | Spenders in the 30-day window whose first spend came before it. |
| `priorSpenders7D` | Prior Spenders (7D) | float64 | | Unique spenders over the 7 days ending 7 days earlier. |
| `priorSpenders30D` | Prior Spenders (30D) | float64 | | Unique spenders over the 30 days ending 30 days earlier. |
| `netChurn7D` | Net Churn (7D) | float64 | | One minus returning spenders over prior spenders for the 7-day window, as a decimal. |
| `netChurn30D` | Net Churn (30D) | float64 | | One minus returning spenders over prior spenders for the 30-day window, as a decimal. |

## Columns

Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes).

| Field | Type | Filters | Sort | Description |
| - | - | - | - | - |
| `id` | string | `Eq`, `IsOneOf` | | The series key of the payment-card-accounts timeseries model, the parent slug, chain and program id, joined with underscores. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the card program. |
| `slug` | string | `Eq`, `IsOneOf` | yes | The parent protocol's project slug, the slug used for the same protocol across the API. |
| `parentSlug` | string | `Eq`, `IsOneOf` | yes | The parent protocol's short name. |
| `productSlug` | string | `Eq`, `IsOneOf` | | The product or version within the parent protocol. |
| `chain` | string | `Eq`, `IsOneOf` | | The short name of the chain (ethereum, base, solana). |
| `programID` | string | `Eq`, `IsOneOf` | | The card program's identifier. |
| `programName` | string | `Eq`, `IsOneOf`, `Contains` | | The card program's display name (for example ether.fi Cash). |
| `protocolSlug` | string | `Eq`, `IsOneOf` | | The slug of the protocol record mapped to the product; null when unmapped. |
| `protocolName` | string | `Eq`, `IsOneOf` | | The name of the protocol record mapped to the product; null when unmapped. |
| `projectID` | string | `Eq`, `IsOneOf` | | The identifier of the parent protocol's project record; null when unmapped. |
| `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/payment-card-accounts/1d/<id>?timeframe=7d&selections=accountsCreated,activeAccounts" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Payment Card Account timeseries](https://docs.blockworks.com/api-reference/data-api/payment-cards/timeseries-payment-card-accounts-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.