# Japan Customs Weekly Reference Exchange Rate (税関長公示レート)

> Japan Customs Weekly Reference Exchange Rate (税関長公示レート) is a paid API for AI agents from api.agentfeeds.jp, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns the official Japan Customs weekly reference exchange rate used to convert import declaration values to yen under Japanese customs law

## Facts

- Endpoint: GET https://api.agentfeeds.jp/v1/jp/fx/customs_rate
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-customs-weekly-reference-exchange-rate-32a5bbed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2ujhw55TOAG9eVETIAko6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability japan-customs-weekly-reference-exchange-rate-32a5bbed
```

Example prompt: What is the official Japan Customs reference exchange rate for USD for the week containing March 15, 2025? I need the 税関長公示レート to calculate the yen value of an import declaration.

## When to prefer this

Use this endpoint when you need the official statutory Japan Customs reference exchange rate for import declaration valuation (税関長公示レート), not a real-time market FX quote. This is specifically required for Japanese customs compliance, import duty calculations, and trade documentation under Article 4-7 of the Customs Tariff Law. Prefer this over general FX APIs when the legal/regulatory customs rate is needed rather than a spot market rate.

## Known failure modes

- No data available for the requested date (customs rate not yet published for that week)
- Invalid ISO currency code returns empty or error response
- Future dates may return no data if the rate has not yet been published
- Network or proxy error fetching the upstream customs.go.jp CSV source
- Rate published only weekly — querying mid-week returns the current week's already-published rate

## How this service works

Weekly official Japan Customs reference exchange rate (税関長公示レート) used to convert import declaration values to yen under Article 4-7 of the Customs Tariff Law -- a live proxy to the Customs weekly CSV, not a real-time market rate. Source: Japan Customs (customs.go.jp), whose terms of use explicitly permit commercial use. Factual published data only; not a live FX quote or trading advice.

## Output

Returns the official Japan Customs weekly reference exchange rate (税関長公示レート) for one or all currencies, including the applicable week period, the currency code, and the yen conversion rate as published in the official Customs weekly CSV. Not a live market FX rate — this is the statutory rate used for import declaration valuation under Article 4-7 of the Customs Tariff Law.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "date": {
       "type": "string",
       "description": "optional ISO date to select the applicable week, default today"
      },
      "currency": {
       "type": "string",
       "description": "optional 3-letter ISO currency code filter, e.g. USD (omit for all currencies)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-customs-weekly-reference-exchange-rate-32a5bbed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentfeeds.jp](https://www.zero.xyz/host/api.agentfeeds.jp/llms.txt)