List carbon credit buyers

curl --request GET \
  --url https://vcm-fyi-api.fly.dev/v1/buyers/ \
  --header 'X-API-KEY: <api-key>'

{
  "pagination": {
    "total_entries": 123,
    "current_page": 123,
    "total_pages": 123,
    "next_page": "<string>"
  },
  "data": [
    {
      "buyer_name": "<string>",
      "total_volume": 123,
      "volume_12m": 123,
      "volume_60d": 123,
      "avg_transaction_size": 123,
      "total_transactions": 123,
      "transactions_12m": 123,
      "transactions_60d": 123,
      "transactions_per_year": 123,
      "first_purchase": "2023-12-25",
      "last_purchase": "2023-12-25",
      "days_since_last": 123,
      "top_category": "<string>",
      "top_country": "<string>",
      "top_registry": "<string>",
      "is_active_12m": true,
      "is_active_60d": true
    }
  ]
}

Buyers

List carbon credit buyers

Get aggregated buyer statistics derived from retirement transaction data.

Buyer names are harmonized across registries — the same entity appearing under different names is resolved to a canonical name where possible.

How it works: Aggregates all retirement transactions by buyer, computing volume metrics, transaction counts, and activity flags. Project and credit filters are applied before aggregation; buyer-specific filters (volume ranges, activity flags) are applied after.

Key metrics per buyer:

total_volume / volume_12m / volume_60d — retired credit quantities
total_transactions / transactions_12m / transactions_60d — transaction counts
avg_transaction_size — average credits per retirement
is_active_12m / is_active_60d — activity flags
first_purchase / last_purchase / days_since_last — temporal data

Sorting: Available fields: total_volume, volume_12m, volume_60d, avg_transaction_size, total_transactions, transactions_12m, transactions_60d, first_purchase, last_purchase. Prefix with - for descending.

Example queries:

Buyers of forest credits in Brazil: ?category=forest&country=Brazil
Active buyers (last 60 days): ?is_active_60d=true
High-volume buyers: ?total_volume_min=100000

GET

buyers

List carbon credit buyers

curl --request GET \
  --url https://vcm-fyi-api.fly.dev/v1/buyers/ \
  --header 'X-API-KEY: <api-key>'

{
  "pagination": {
    "total_entries": 123,
    "current_page": 123,
    "total_pages": 123,
    "next_page": "<string>"
  },
  "data": [
    {
      "buyer_name": "<string>",
      "total_volume": 123,
      "volume_12m": 123,
      "volume_60d": 123,
      "avg_transaction_size": 123,
      "total_transactions": 123,
      "transactions_12m": 123,
      "transactions_60d": 123,
      "transactions_per_year": 123,
      "first_purchase": "2023-12-25",
      "last_purchase": "2023-12-25",
      "days_since_last": 123,
      "top_category": "<string>",
      "top_country": "<string>",
      "top_registry": "<string>",
      "is_active_12m": true,
      "is_active_60d": true
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

Query Parameters

project_id

string[] | null

Filter by specific project ID(s)

current_page

integer

default:1

Page number

Required range: x >= 1

per_page

integer

default:100

Items per page

Required range: 1 <= x <= 200

sort

string[]

List of sorting parameters. Available: total_volume, volume_12m, volume_60d, avg_transaction_size, total_transactions, transactions_12m, transactions_60d, transactions_per_year, first_purchase, last_purchase, days_since_last. Prefix with - for descending.

registry

enum<string>[] | null

Registry name

Available options:

verra,

gold-standard,

american-carbon-registry,

climate-action-reserve,

art-trees,

isometric,

puro-earth,

plan-vivo,

none

country

string[] | null

Country name

protocol

string[] | null

Protocol name

Response

Paginated list of buyers with aggregated retirement statistics

pagination

Pagination · object

required

Show child attributes

data

BuyerStats · object

required

BuyerStats · object[]
Data · object[]

Show child attributes

List credit transactions Get buyer details

⌘I

Projects

Credits

Buyers

Charts

Countries

Forensics

Proponent Forensics

Satellite

Supply & Demand

API Keys

List carbon credit buyers

Authorizations

Query Parameters

Response