Payment Card Accounts

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

List Payment Card Accounts

One page of rows with per-column filters, sorting and pagination.

Batch Get Payment Card Account timeseries

Up to 10 series in one request, named by Payment Card Account ID in series.

Get Payment Card Account timeseries

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	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

curl

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 for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts