Get Aggregate and Per-Chain Metrics

$	curl https://api.agora.finance/v0/metrics

{
  "chains": [
    {
      "chainId": "eip155:1",
      "circulatingSupply": "68500000.123456",
      "network": "ethereum",
      "totalSupply": "72100000.123456"
    },
    {
      "chainId": "eip155:42161",
      "circulatingSupply": "612.000000",
      "network": "arbitrum",
      "totalSupply": "612.000000"
    },
    {
      "chainId": "eip155:43114",
      "circulatingSupply": "9450000.500000",
      "network": "avalanche",
      "totalSupply": "11400000.500000"
    },
    {
      "chainId": "eip155:8453",
      "circulatingSupply": "142000.500000",
      "network": "base",
      "totalSupply": "142000.500000"
    },
    {
      "chainId": "eip155:56",
      "circulatingSupply": "1100.000000",
      "network": "binance-smart-chain",
      "totalSupply": "1100.000000"
    },
    {
      "chainId": "eip155:1116",
      "circulatingSupply": "950.000000",
      "network": "core",
      "totalSupply": "950.000000"
    },
    {
      "chainId": "eip155:252",
      "circulatingSupply": "0.000000",
      "network": "fraxtal",
      "totalSupply": "0.000000"
    },
    {
      "chainId": "eip155:100",
      "circulatingSupply": "5.500000",
      "network": "gnosis",
      "totalSupply": "5.500000"
    },
    {
      "chainId": "eip155:13371",
      "circulatingSupply": "8800000.000000",
      "network": "immutable",
      "totalSupply": "8800001.000000"
    },
    {
      "chainId": "cosmos:injective-1",
      "circulatingSupply": "1200000.000000",
      "network": "injective",
      "totalSupply": "4250000.000000"
    },
    {
      "chainId": "eip155:747474",
      "circulatingSupply": "2300000.000000",
      "network": "katana",
      "totalSupply": "3300000.000000"
    },
    {
      "chainId": "eip155:5000",
      "circulatingSupply": "5200000.000000",
      "network": "mantle",
      "totalSupply": "5200000.000000"
    },
    {
      "chainId": "eip155:143",
      "circulatingSupply": "33500000.000000",
      "network": "monad",
      "totalSupply": "37000000.000000"
    },
    {
      "chainId": "eip155:98866",
      "circulatingSupply": "0.000000",
      "network": "plume",
      "totalSupply": "0.000000"
    },
    {
      "chainId": "eip155:137",
      "circulatingSupply": "1750000.000000",
      "network": "polygon-pos",
      "totalSupply": "4800000.000000"
    },
    {
      "chainId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "circulatingSupply": "1400000.000000",
      "network": "solana",
      "totalSupply": "4100000.000000"
    },
    {
      "chainId": "sui:mainnet",
      "circulatingSupply": "500000.000000",
      "network": "sui",
      "totalSupply": "500000.000000"
    }
  ],
  "partial": false,
  "circulatingSupply": "132744668.623456",
  "totalSupply": "151594669.623456"
}

The endpoints exposed here are currently in Beta! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution.

<Callout intent="warning"> The endpoints exposed here are currently in **Beta**! As we continue to build our initial offering, these endpoints may implement breaking changes. Be sure to check back for our change log regularly as a precaution. </Callout>

Response

Aggregate and per-chain AUSD supply breakdown. When one or more chains are temporarily unavailable, the response sets partial: true and omits aggregate totalSupply and circulatingSupply rather than publishing a silently-truncated figure.

chainslist of objects

Per-chain supply breakdown. Only chains with a currently cached successful result are included; chains that have never succeeded (or are in a persistent outage on this pod) are omitted and cause partial to be true.

partialboolean

True when one or more chains are missing from the response (cold start before a chain’s first successful fetch, or a persistent chain outage). When true, aggregate totalSupply and circulatingSupply are omitted — publishing a total that silently excludes chains would look like a large supply drop to market-data consumers.

circulatingSupplystring

Aggregate circulating AUSD supply across all chains, as a decimal string (e.g. 987654321.654321). This is the sum of all per-chain circulatingSupply values. Omitted when partial is true.

totalSupplystring

Aggregate total AUSD supply across all chains, as a decimal string (e.g. 1234567890.123456). This is the sum of all per-chain totalSupply values. Omitted when partial is true.

Errors

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error