{
  "x402Version": 2,
  "id": 39817,
  "slug": "39817",
  "resource": "https://thevaultreport.com/api/x402/premiums",
  "description": "Physical premiums with tax-wedge decomposition: for each venue (Shanghai/Tokyo/India/London) the gross premium over COMEX, the embedded import-duty/VAT/consumption-tax wedge, and the ex-tax 'market' premium — the real physical-demand signal after stripping tax distortion. Optional ?metal=gold|silver|platinum|palladium.",
  "type": "http",
  "resourceType": "Market Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x74500ee8519da3b6bf43642bc06be5874a9ecc99",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000",
      "amountUsd": 0.02,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "properties": {
          "attribution": {
            "type": "string"
          },
          "endpoint": {
            "type": "string"
          },
          "generated_at": {
            "format": "date-time",
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "note": {
            "type": "string"
          },
          "returned": {
            "type": "integer"
          },
          "rows": {
            "items": {
              "properties": {
                "as_of": {
                  "format": "date-time",
                  "type": "string"
                },
                "comex_ref_usd_per_oz": {
                  "type": "number"
                },
                "contract": {
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "ex_tax_premium_pct": {
                  "type": "number"
                },
                "gross_premium_pct": {
                  "type": "number"
                },
                "local_price": {
                  "type": "number"
                },
                "metal": {
                  "type": "string"
                },
                "source": {
                  "type": "string"
                },
                "tax_wedge_pct": {
                  "type": "number"
                },
                "unit": {
                  "type": "string"
                },
                "usd_per_oz": {
                  "type": "number"
                },
                "venue": {
                  "type": "string"
                },
                "wedge_label": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "schema_version": {
            "type": "integer"
          },
          "source": {
            "type": "string"
          },
          "source_url": {
            "type": "string"
          }
        },
        "required": [
          "endpoint",
          "rows"
        ],
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "metal": "gold"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "attribution": "Attribute to The Vault Report with a link to https://thevaultreport.com",
            "endpoint": "premiums",
            "generated_at": "2026-04-18T14:00:00Z",
            "license": "CC BY 4.0",
            "returned": 1,
            "rows": [
              {
                "as_of": "2026-04-18T14:00:00Z",
                "comex_ref_usd_per_oz": 3391.2,
                "contract": "au9999",
                "currency": "CNY",
                "ex_tax_premium_pct": 0.6,
                "gross_premium_pct": 13.6,
                "local_price": 790.5,
                "metal": "GOLD",
                "source": "sina_shfe",
                "tax_wedge_pct": 13,
                "unit": "gram",
                "usd_per_oz": 3412.8,
                "venue": "Shanghai",
                "wedge_label": "VAT"
              }
            ],
            "schema_version": 1,
            "source": "The Vault Report",
            "source_url": "https://thevaultreport.com"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "metal": {
                    "enum": [
                      "gold",
                      "silver",
                      "copper",
                      "platinum"
                    ],
                    "example": "gold",
                    "type": "string"
                  }
                },
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "properties": {
                  "attribution": {
                    "type": "string"
                  },
                  "endpoint": {
                    "type": "string"
                  },
                  "generated_at": {
                    "format": "date-time",
                    "type": "string"
                  },
                  "license": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  },
                  "returned": {
                    "type": "integer"
                  },
                  "rows": {
                    "items": {
                      "properties": {
                        "as_of": {
                          "format": "date-time",
                          "type": "string"
                        },
                        "comex_ref_usd_per_oz": {
                          "type": "number"
                        },
                        "contract": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        },
                        "ex_tax_premium_pct": {
                          "type": "number"
                        },
                        "gross_premium_pct": {
                          "type": "number"
                        },
                        "local_price": {
                          "type": "number"
                        },
                        "metal": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string"
                        },
                        "tax_wedge_pct": {
                          "type": "number"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "usd_per_oz": {
                          "type": "number"
                        },
                        "venue": {
                          "type": "string"
                        },
                        "wedge_label": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "schema_version": {
                    "type": "integer"
                  },
                  "source": {
                    "type": "string"
                  },
                  "source_url": {
                    "type": "string"
                  }
                },
                "required": [
                  "endpoint",
                  "rows"
                ],
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "thevaultreport.com",
  "lastUpdated": "2026-10-03T04:30:47.887Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-03T04:30:47.589Z"
  },
  "metadata": {
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "metal": "gold"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "attribution": "Attribute to The Vault Report with a link to https://thevaultreport.com",
              "endpoint": "premiums",
              "generated_at": "2026-04-18T14:00:00Z",
              "license": "CC BY 4.0",
              "returned": 1,
              "rows": [
                {
                  "as_of": "2026-04-18T14:00:00Z",
                  "comex_ref_usd_per_oz": 3391.2,
                  "contract": "au9999",
                  "currency": "CNY",
                  "ex_tax_premium_pct": 0.6,
                  "gross_premium_pct": 13.6,
                  "local_price": 790.5,
                  "metal": "GOLD",
                  "source": "sina_shfe",
                  "tax_wedge_pct": 13,
                  "unit": "gram",
                  "usd_per_oz": 3412.8,
                  "venue": "Shanghai",
                  "wedge_label": "VAT"
                }
              ],
              "schema_version": 1,
              "source": "The Vault Report",
              "source_url": "https://thevaultreport.com"
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "properties": {
                    "metal": {
                      "enum": [
                        "gold",
                        "silver",
                        "copper",
                        "platinum"
                      ],
                      "example": "gold",
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "properties": {
                    "attribution": {
                      "type": "string"
                    },
                    "endpoint": {
                      "type": "string"
                    },
                    "generated_at": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "license": {
                      "type": "string"
                    },
                    "note": {
                      "type": "string"
                    },
                    "returned": {
                      "type": "integer"
                    },
                    "rows": {
                      "items": {
                        "properties": {
                          "as_of": {
                            "format": "date-time",
                            "type": "string"
                          },
                          "comex_ref_usd_per_oz": {
                            "type": "number"
                          },
                          "contract": {
                            "type": "string"
                          },
                          "currency": {
                            "type": "string"
                          },
                          "ex_tax_premium_pct": {
                            "type": "number"
                          },
                          "gross_premium_pct": {
                            "type": "number"
                          },
                          "local_price": {
                            "type": "number"
                          },
                          "metal": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          },
                          "tax_wedge_pct": {
                            "type": "number"
                          },
                          "unit": {
                            "type": "string"
                          },
                          "usd_per_oz": {
                            "type": "number"
                          },
                          "venue": {
                            "type": "string"
                          },
                          "wedge_label": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "schema_version": {
                      "type": "integer"
                    },
                    "source": {
                      "type": "string"
                    },
                    "source_url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "endpoint",
                    "rows"
                  ],
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "thevaultreport.com",
    "manifest_name": "thevaultreport.com",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "attribution": "Attribute to The Vault Report with a link to https://thevaultreport.com",
    "endpoint": "premiums",
    "generated_at": "2026-04-18T14:00:00Z",
    "license": "CC BY 4.0",
    "returned": 1,
    "rows": [
      {
        "as_of": "2026-04-18T14:00:00Z",
        "comex_ref_usd_per_oz": 3391.2,
        "contract": "au9999",
        "currency": "CNY",
        "ex_tax_premium_pct": 0.6,
        "gross_premium_pct": 13.6,
        "local_price": 790.5,
        "metal": "GOLD",
        "source": "sina_shfe",
        "tax_wedge_pct": 13,
        "unit": "gram",
        "usd_per_oz": 3412.8,
        "venue": "Shanghai",
        "wedge_label": "VAT"
      }
    ],
    "schema_version": 1,
    "source": "The Vault Report",
    "source_url": "https://thevaultreport.com"
  }
}