Top credit buyers by retirement volume
Get the top buyers ranked by total retired credit quantity.
Returns a ranked list of buyers with their total retired volume, number of projects purchased from, and transaction count. Also includes aggregate totals across all buyers.
Buyer names are harmonized and cleaned — junk entries (e.g., “undisclosed”, “n/a”, cancellations) are excluded.
Parameters:
limit: Number of top buyers to return (1-100, default: 20).
Filters: All standard project and credit filters apply, letting you find top buyers for specific registries, countries, or categories.
Authorizations
Query Parameters
Case insensitive search string. Currently searches on project_id and name fields only.
Number of top buyers to return
1 <= x <= 100Registry name
verra, gold-standard, american-carbon-registry, climate-action-reserve, art-trees, isometric, puro-earth, plan-vivo, none Country name
Protocol name
Category name
Whether project is an ARB project
Format: YYYY-MM-DD
Format: YYYY-MM-DD
Minimum number of issued credits
Maximum number of issued credits
Minimum number of retired credits
Maximum number of retired credits
Project type
Project proponent/developer name
UN SDG goals (1-17). Multiple values = AND filter (must have ALL selected goals)
Specific certification labels (e.g., ccb-gold, ccb-biodiversity-gold, corsia). Multiple values = OR filter
Puro.earth CORC durability (100+ or 1000+). Multiple values = OR filter
Has CCB (Climate, Community & Biodiversity) certification
Has ICVCM Core Carbon Principles certification
CORSIA eligible
Has SD VISta certification
Has Social Carbon certification
Authorized under Paris Agreement Article 6
Article 6 authorization types: NDC Use, Intl mitigation purposes, Other purposes
Transaction type
Vintage
Format: YYYY-MM-DD
Format: YYYY-MM-DD
Minimum transaction quantity
Maximum transaction quantity
Response
Ranked list of top buyers with total stats
The response is of type Response Get Top Buyers V1 Charts Top Buyers Get · object.