{
  "x402Version": 2,
  "discoverable": true,
  "status": "ready_for_wal",
  "name": "stablecoin-attestations",
  "description": "Stablecoin reserve attestations as JSON: reserves, composition, attestor, on-chain supply, ratio.",
  "category": "data",
  "tags": [
    "stablecoin",
    "reserves",
    "attestation",
    "proof-of-reserves",
    "defi"
  ],
  "resource": {
    "url": "https://agentwares-stablecoin.vercel.app/v1/reserves/{symbol}",
    "method": "GET",
    "type": "http"
  },
  "price": {
    "amountUsd": "0.05",
    "asset": "USDC",
    "network": "eip155:8453"
  },
  "sample_url": "https://agentwares-stablecoin.vercel.app/v1/reserves/USDC?sample=1",
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "pathParams": {
            "symbol": "USDC"
          },
          "queryParams": {
            "period": "2026-07"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "issuer": "Circle Internet Financial, LLC",
            "symbol": "USDC",
            "name": "USD Coin",
            "peg": "USD",
            "backing": "fiat",
            "as_of": "2026-07-31",
            "period": "2026-07",
            "currency": "USD",
            "total_reserves_usd": 71904101332,
            "tokens_in_circulation_reported": 71826453410,
            "composition": [
              {
                "category": "us_treasury_bills",
                "label": "TOTAL U.S. TREASURY SECURITIES (Circle Reserve Fund)",
                "amount_usd": 7179080057,
                "share": 0.099842
              },
              {
                "category": "us_treasury_repo",
                "label": "U.S. Treasury Repurchase Agreements",
                "amount_usd": 52723000000,
                "share": 0.733241
              },
              {
                "category": "cash_in_fund",
                "label": "Cash held in Circle Reserve Fund",
                "amount_usd": 1003971911,
                "share": 0.013963
              },
              {
                "category": "receivables_adjustments",
                "label": "Cash due to/(owed by) Circle Reserve Fund due to timing and settlement differences, net",
                "amount_usd": -188805003,
                "share": -0.002626
              },
              {
                "category": "us_treasury_bills",
                "label": "TOTAL U.S. TREASURY SECURITIES (Other USDC Reserve Assets)",
                "amount_usd": 499418694,
                "share": 0.006946
              },
              {
                "category": "cash_at_banks",
                "label": "Cash held at regulated financial institutions",
                "amount_usd": 10607410596,
                "share": 0.147522
              },
              {
                "category": "receivables_adjustments",
                "label": "Cash due to/(owed by) Circle due to timing and settlement differences, net",
                "amount_usd": 80025077,
                "share": 0.001113
              }
            ],
            "attestor": "Deloitte & Touche LLP",
            "attestation_type": "examination",
            "cadence": "monthly",
            "source_url": "https://www.circle.com/transparency",
            "report_url": "https://6778953.fs1.hubspotusercontent-na1.net/hubfs/6778953/USDCAttestationReports/2026/2026%20USDC_Examination%20Report%20July%2026%20(1).pdf",
            "issued_on": "2026-08-27",
            "onchain_supply": {
              "amount": 74699845698,
              "currency": "USD",
              "as_of": "2026-09-07T04:13:19.684Z",
              "source": "defillama",
              "defillama_id": "2",
              "price_usd": 0.99985815405514
            },
            "reserve_ratio": 1.001081,
            "reserve_ratio_vs_onchain_supply": 0.962574,
            "confidence": "high",
            "checks": {
              "composition_sums_to_total": true,
              "composition_gap": 0,
              "reserves_cover_circulation": true
            },
            "history_available": [
              "2026-07",
              "2026-06",
              "2026-05",
              "2026-04",
              "2026-03",
              "2026-02",
              "2026-01",
              "2025-12",
              "2025-11",
              "2025-10",
              "2025-09",
              "2025-08"
            ],
            "sources": [
              "https://www.circle.com/transparency",
              "https://6778953.fs1.hubspotusercontent-na1.net/hubfs/6778953/USDCAttestationReports/2026/2026%20USDC_Examination%20Report%20July%2026%20(1).pdf",
              "https://defillama.com/stablecoin/2"
            ],
            "sample": true,
            "notice": "Informational only, not financial, investment or legal advice. Figures are parsed from the issuer's own published attestation (see source_url) and DefiLlama's public supply feed; the attestation date (as_of) and the on-chain supply date differ. Verify against the source document before relying on any number. Sample mode: this is the free USDC example; paid calls return the issuer you asked for."
          }
        }
      },
      "schema": {
        "type": "object",
        "properties": {
          "input": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "symbol": {
                "description": "Token symbol, case-insensitive: USDC, USDT, PYUSD, RLUSD, ... (see stablecoin_list_issuers)",
                "type": "string",
                "minLength": 1
              },
              "issuer": {
                "description": "Issuer name or registry id when the symbol is unknown, e.g. \"circle\" or \"paxos\"",
                "type": "string",
                "minLength": 1
              },
              "period": {
                "description": "Report month as YYYY-MM. Default: the newest parsed month. See history_available.",
                "type": "string",
                "pattern": "^\\d{4}-\\d{2}$"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "issuer": {
                "type": "string"
              },
              "symbol": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "peg": {
                "type": "string"
              },
              "backing": {
                "type": "string"
              },
              "as_of": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "period": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "currency": {
                "type": "string"
              },
              "total_reserves_usd": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "tokens_in_circulation_reported": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "composition": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "category": {
                      "type": "string",
                      "enum": [
                        "cash_at_banks",
                        "cash_in_fund",
                        "us_treasury_bills",
                        "us_treasury_repo",
                        "money_market_fund",
                        "tokenized_fund",
                        "other_government_securities",
                        "commercial_paper",
                        "corporate_bonds",
                        "precious_metals",
                        "bitcoin",
                        "secured_loans",
                        "crypto_collateral",
                        "receivables_adjustments",
                        "other"
                      ]
                    },
                    "label": {
                      "type": "string"
                    },
                    "amount_usd": {
                      "type": "number"
                    },
                    "share": {
                      "type": [
                        "number",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "category",
                    "label",
                    "amount_usd",
                    "share"
                  ],
                  "additionalProperties": false
                }
              },
              "attestor": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "attestation_type": {
                "type": "string"
              },
              "cadence": {
                "type": "string"
              },
              "source_url": {
                "type": "string"
              },
              "report_url": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "issued_on": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "onchain_supply": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "currency": {
                        "type": "string"
                      },
                      "as_of": {
                        "type": "string"
                      },
                      "source": {
                        "type": "string",
                        "const": "defillama"
                      },
                      "defillama_id": {
                        "type": "string"
                      },
                      "price_usd": {
                        "type": [
                          "number",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "amount",
                      "currency",
                      "as_of",
                      "source",
                      "defillama_id",
                      "price_usd"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "reserve_ratio": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "reserve_ratio_vs_onchain_supply": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "confidence": {
                "type": "string",
                "enum": [
                  "high",
                  "medium",
                  "low",
                  "none"
                ]
              },
              "checks": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "composition_sums_to_total": {
                        "type": "boolean"
                      },
                      "composition_gap": {
                        "type": "number"
                      },
                      "reserves_cover_circulation": {
                        "type": [
                          "boolean",
                          "null"
                        ]
                      }
                    },
                    "required": [
                      "composition_sums_to_total",
                      "composition_gap",
                      "reserves_cover_circulation"
                    ],
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "history_available": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "sources": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "sample": {
                "type": "boolean"
              },
              "notice": {
                "type": "string"
              }
            },
            "required": [
              "issuer",
              "symbol",
              "name",
              "peg",
              "backing",
              "as_of",
              "period",
              "currency",
              "total_reserves_usd",
              "tokens_in_circulation_reported",
              "composition",
              "attestor",
              "attestation_type",
              "cadence",
              "source_url",
              "report_url",
              "issued_on",
              "onchain_supply",
              "reserve_ratio",
              "reserve_ratio_vs_onchain_supply",
              "confidence",
              "checks",
              "history_available",
              "sources",
              "sample",
              "notice"
            ],
            "additionalProperties": false
          }
        }
      }
    }
  }
}