settlement costs derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "chains": "base,polygon,arbitrum,ethereum,xdc"
    }
  },
  "output": {
    "type": "json",
    "example": {
      "data": [
        {
          "chain": "xdc",
          "tx_type": "usdc_transfer",
          "cost_bps": [
            {
              "fee_bps": 0.00188,
              "notional_usd": 100
            },
            {
              "fee_bps": 0.000188,
              "notional_usd": 1000
            },
            {
              "fee_bps": 0.0000188,
              "notional_usd": 10000
            }
          ],
          "fee_model": "single_layer",
          "gas_units": 46680,
          "cost_basis": "complete",
          "head_age_s": 3,
          "est_cost_usd": 0.0000188,
          "gas_price_wei": "250000000",
          "fee_components": {
            "total_usd": 0.0000188,
            "l1_data_usd": null,
            "execution_usd": 0.0000188
          },
          "gas_units_method": "eth_estimateGas",
          "gas_units_assumed": null,
          "gas_units_scenario": "transfer to an address with an existing USDC balance",
          "l1_data_fee_included": null,
          "transfer_amount_atomic": 1000000
        }
      ],
      "meta": {
        "units": {
          "fee_bps": "basis_points",
          "est_cost_usd": "usd",
          "gas_price_wei": "wei",
          "transfer_amount_atomic": "usdc_atomic"
        },
        "sources": [
          {
            "id": "xdc.rpc.gas_price",
            "kind": "onchain_read",
            "block": 85797652,
            "max_age_s": 120,
            "fetched_at": "2026-08-30T22:14:02.904Z"
          },
          {
            "id": "xdc.rpc.gas_units",
            "kind": "onchain_simulation",
            "method": "eth_estimateGas",
            "max_age_s": 120,
            "fetched_at": "2026-08-30T22:14:02.904Z"
          },
          {
            "id": "coingecko.simple.licensed.xdc",
            "url": "https://www.coingecko.com/en/api",
            "kind": "public_api",
            "licensed": true,
            "max_age_s": 120,
            "fetched_at": "2026-08-30T22:14:03.011Z",
            "attribution": "Data provided by CoinGecko",
            "quote_asset": "usd",
            "fallback_used": false,
            "license_basis": "operator_attestation"
          }
        ],
        "version": "0.1.0",
        "freshness": {
          "cache_ttl_s": 119,
          "valid_until": "2026-08-30T22:16:02.904Z",
          "policy_max_age_s": 120,
          "oldest_source_age_s": 1,
          "all_sources_within_policy": true
        },
        "capability": "compass.settlement.costs",
        "request_id": "req_example1",
        "limitations": "a simulated transfer to an address that already holds the token; a first transfer to a fresh address costs more, and no bridge, mint or subscription cost is included",
        "attributions": [
          {
            "url": "https://www.coingecko.com/en/api",
            "message": "Data provided by CoinGecko",
            "source_id": "coingecko.simple.licensed.xdc",
            "fetched_at": "2026-08-30T22:14:03.011Z",
            "quote_asset": "usd",
            "fallback_used": false
          }
        ],
        "generated_at": "2026-08-30T22:14:03.117Z",
        "schema_version": "0.5.0",
        "chains_requested": [
          "xdc"
        ],
        "fee_completeness": "complete",
        "chains_unavailable": []
      },
      "related": [
        "compass.rwa.yields",
        "compass.ping"
      ],
      "cheapest": {
        "chain": "xdc",
        "scope": "transaction_fee_total",
        "caveats": [],
        "runner_up": null,
        "stability": {
          "level": "unknown",
          "historical_claim": false
        },
        "est_cost_usd": 0.0000188,
        "compared_chains": [
          "xdc"
        ],
        "excluded_chains": []
      }
    }
  }
}