{
  "openapi": "3.1.0",
  "info": {
    "title": "ANIME INTELLIGENCE API",
    "version": "3.3.2",
    "description": "AI-native intelligence and purchase-decision infrastructure for Japanese anime collectibles and character merchandise: figures, plush, acrylic goods, keychains, badges, lottery prizes, model kits, trading cards, collaboration sneakers and apparel. Start with free canonical search or the 0.005 USDC identify endpoint, then buy only the market, rarity, authenticity, BUY-WAIT, best-place or full-intelligence signal the agent needs."
  },
  "servers": [
    {
      "url": "https://anime-intelligence.goodmy0312.workers.dev"
    }
  ],
  "tags": [
    {
      "name": "free-search",
      "description": "Free canonical product discovery."
    },
    {
      "name": "anime-collectibles",
      "description": "Paid x402 intelligence for Japanese anime collectibles."
    }
  ],
  "paths": {
    "/v1/search": {
      "get": {
        "operationId": "searchAnimeProduct",
        "summary": "Search canonical Japanese anime collectibles for free",
        "description": "Free canonical lookup. Use this to resolve likely product candidates before choosing a paid intelligence endpoint.",
        "tags": [
          "free-search",
          "anime-collectibles"
        ],
        "security": [],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "examples": {
              "jan": {
                "value": "4580590123456"
              },
              "name": {
                "value": "Nendoroid Hatsune Miku"
              },
              "series": {
                "value": "POP UP PARADE Loona L size"
              }
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Canonical product candidates",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string"
                    },
                    "version": {
                      "type": "string"
                    },
                    "query": {
                      "type": "string"
                    },
                    "count": {
                      "type": "integer"
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid"
                          },
                          "name_ja": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "name_en": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "manufacturer": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "jan_code": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "product_type": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "identification_confidence": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/identify": {
      "get": {
        "operationId": "identify",
        "summary": "ANIME INTELLIGENCE Identify",
        "description": "Identify the exact Japanese anime collectible or character merchandise item before pricing or buying. Resolves figures, plush, acrylic goods, keychains, badges, lottery prizes, model kits, trading cards, collaboration sneakers and apparel using JAN/EAN, model or style codes, manufacturer or brand data, aliases and canonical identity evidence. WHEN TO USE: Use first for figures, plush, acrylic stands, keychains, badges, lottery prizes, model kits, trading cards, collaboration sneakers or apparel when the exact product, edition or variant is uncertain.",
        "tags": [
          "anime-collectibles",
          "japanese-character-goods",
          "anime-merchandise",
          "product-identification",
          "jan-ean",
          "edition-identification",
          "variant-identification",
          "official-product-data",
          "collectibles-shopping"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Nendoroid Hatsune Miku"
              },
              "secondary": {
                "value": "ONE PIECE 缶バッジ"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Resolve an ambiguous Japanese anime collectible or character merchandise item into one exact canonical product before valuation or purchase.",
        "x-when-to-use": "Use first for figures, plush, acrylic stands, keychains, badges, lottery prizes, model kits, trading cards, collaboration sneakers or apparel when the exact product, edition or variant is uncertain.",
        "x-value": "exact_product_identity",
        "x-output-fields": [
          "canonical identity",
          "product type",
          "JAN/EAN",
          "manufacturer or brand",
          "series or franchise",
          "edition or variant",
          "release data",
          "official source evidence",
          "identity quality"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.005"
          },
          "price_usdc": 0.005,
          "price_atomic": "5000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/identify",
                      "charged": true,
                      "product": {
                        "id": "canonical-product-uuid",
                        "name_ja": "商品正式名",
                        "name_en": "Official Product Name",
                        "jan_code": "4580590123456",
                        "manufacturer": "Good Smile Company"
                      },
                      "identity_quality": 95
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/market": {
      "get": {
        "operationId": "market",
        "summary": "ANIME INTELLIGENCE Market",
        "description": "Current matched asking-price and market-value intelligence for Japanese anime collectibles and character merchandise. Uses supported marketplace observations to estimate low, median and high asking prices, offer count, freshness and best matched purchase route while rejecting likely identity mismatches. WHEN TO USE: Use after identity is known for current price, market value, resale value, price range, cheapest matched offer or availability across supported marketplaces.",
        "tags": [
          "anime-collectibles",
          "japanese-character-goods",
          "anime-merchandise",
          "collectible-price",
          "collectible-valuation",
          "market-value",
          "resale-value",
          "price-comparison",
          "yahoo-japan",
          "ebay"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Nendoroid Hatsune Miku"
              },
              "secondary": {
                "value": "ONE PIECE 一番くじ A賞"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Get current asking-price and market-value intelligence for an identified Japanese anime collectible.",
        "x-when-to-use": "Use after identity is known for current price, market value, resale value, price range, cheapest matched offer or availability across supported marketplaces.",
        "x-value": "current_market_prices",
        "x-output-fields": [
          "lowest price",
          "median price",
          "highest price",
          "offer count",
          "market freshness",
          "best matched listing",
          "purchase routing"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "price_usdc": 0.01,
          "price_atomic": "10000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/market",
                      "charged": true,
                      "market": {
                        "currency": "JPY",
                        "lowest_price_jpy": 12800,
                        "median_price_jpy": 14200,
                        "highest_price_jpy": 16800,
                        "offer_count": 6,
                        "freshness": "live_or_recent"
                      },
                      "best_observed_listing": {
                        "source": "yahoo",
                        "price_jpy": 12800
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/rarity": {
      "get": {
        "operationId": "rarity",
        "summary": "ANIME INTELLIGENCE Rarity",
        "description": "Estimate rarity, scarcity and rerelease or replenishment risk for Japanese anime collectibles using matched supply, price premium, release age, limited-edition metadata and known release signals. Supports figures and character goods as well as specialist collectible categories. WHEN TO USE: Use for rare, limited, discontinued, hard-to-find, collectible, appreciation or rerelease-risk questions across supported anime collectible categories.",
        "tags": [
          "anime-collectibles",
          "collectible-rarity",
          "collectible-scarcity",
          "limited-edition",
          "hard-to-find",
          "rerelease-risk",
          "anime-merchandise",
          "trading-card-rarity"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "ONE PIECE 一番くじ 限定 A賞"
              },
              "secondary": {
                "value": "Nendoroid 1000"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Estimate scarcity, collectibility and rerelease or replenishment risk for the exact item.",
        "x-when-to-use": "Use for rare, limited, discontinued, hard-to-find, collectible, appreciation or rerelease-risk questions across supported anime collectible categories.",
        "x-value": "scarcity_and_rerelease_risk",
        "x-output-fields": [
          "rarity score",
          "rarity level",
          "supply signals",
          "price premium signals",
          "rerelease or replenishment risk"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.01"
          },
          "price_usdc": 0.01,
          "price_atomic": "10000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/rarity",
                      "charged": true,
                      "rarity": {
                        "score": 74,
                        "level": "rare",
                        "rerelease_risk": "medium",
                        "signals": [
                          "limited supply",
                          "release age"
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/authenticity": {
      "get": {
        "operationId": "authenticity",
        "summary": "ANIME INTELLIGENCE Authenticity",
        "description": "Assess counterfeit, bootleg and suspicious-listing risk for Japanese anime collectibles and character merchandise before purchase. Combines canonical identity, official references, price relationships and matched listing signals to surface risk rather than treating every cheap offer as equivalent. WHEN TO USE: Use for suspiciously cheap offers, bootleg concerns, missing official references, questionable listings or authenticity risk across supported collectible categories.",
        "tags": [
          "anime-collectibles",
          "bootleg-detection",
          "counterfeit-risk",
          "authenticity",
          "listing-risk",
          "collectible-safety",
          "anime-merchandise"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Is this Nendoroid likely authentic?"
              },
              "secondary": {
                "value": "Is this cheap anime collectible listing suspicious?"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Estimate counterfeit, bootleg or suspicious-listing risk before an agent recommends a purchase.",
        "x-when-to-use": "Use for suspiciously cheap offers, bootleg concerns, missing official references, questionable listings or authenticity risk across supported collectible categories.",
        "x-value": "counterfeit_and_listing_risk",
        "x-output-fields": [
          "risk score",
          "risk level",
          "risk reasons",
          "suspicious listing signals"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "price_usdc": 0.02,
          "price_atomic": "20000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/authenticity",
                      "charged": true,
                      "authenticity_risk": {
                        "score": 18,
                        "level": "low",
                        "reasons": [
                          "official identity matched",
                          "price not abnormally low"
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/buy-wait": {
      "get": {
        "operationId": "buyWait",
        "summary": "ANIME INTELLIGENCE Buy Wait",
        "description": "Return BUY, WAIT, WATCH or AVOID for an identified Japanese anime collectible using current price, reference price, availability, rarity, rerelease or replenishment risk and authenticity signals. Designed as a direct decision layer for autonomous shopping agents. WHEN TO USE: Use when the user asks whether to BUY, WAIT, WATCH or AVOID a figure, character good, card, collaboration sneaker, apparel item or other supported collectible.",
        "tags": [
          "anime-collectibles",
          "buy-or-wait",
          "shopping-decision",
          "collectible-price",
          "rerelease-risk",
          "anime-merchandise",
          "purchase-timing"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Should I buy this Nendoroid now?"
              },
              "secondary": {
                "value": "Buy or wait for this ONE PIECE lottery prize?"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Turn product identity, price, scarcity and risk signals into a concrete purchase-timing decision.",
        "x-when-to-use": "Use when the user asks whether to BUY, WAIT, WATCH or AVOID a figure, character good, card, collaboration sneaker, apparel item or other supported collectible.",
        "x-value": "buy_wait_watch_avoid_decision",
        "x-output-fields": [
          "decision",
          "decision reasons",
          "market snapshot",
          "rarity context",
          "risk context",
          "purchase routing"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.02"
          },
          "price_usdc": 0.02,
          "price_atomic": "20000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/buy-wait",
                      "charged": true,
                      "buy_wait": {
                        "decision": "BUY",
                        "reasons": [
                          "price near fair range",
                          "supply limited"
                        ]
                      },
                      "market_snapshot": {
                        "lowest_price_jpy": 12800
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/best-place": {
      "get": {
        "operationId": "bestPlace",
        "summary": "ANIME INTELLIGENCE Best Place",
        "description": "Find the best current route to buy a specific Japanese anime collectible or character merchandise item. Compares matched supported-marketplace offers by price, identity quality and freshness and returns the strongest current purchase route. WHEN TO USE: Use after product identity is known and the user asks where to buy, cheapest matched offer, best marketplace or best current purchase route.",
        "tags": [
          "anime-collectibles",
          "anime-merchandise",
          "where-to-buy",
          "cheapest-listing",
          "japan-shopping",
          "yahoo-japan",
          "ebay",
          "price-comparison",
          "shopping-agent"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Where should I buy Nendoroid Hatsune Miku?"
              },
              "secondary": {
                "value": "Best place to buy this ONE PIECE badge?"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Choose the best current acquisition route for an already-identified Japanese anime collectible.",
        "x-when-to-use": "Use after product identity is known and the user asks where to buy, cheapest matched offer, best marketplace or best current purchase route.",
        "x-value": "best_current_purchase_route",
        "x-output-fields": [
          "best route",
          "matched marketplace listing",
          "price",
          "seller",
          "identity match quality",
          "market freshness"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.03"
          },
          "price_usdc": 0.03,
          "price_atomic": "30000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/best-place",
                      "charged": true,
                      "best_place": {
                        "source": "yahoo",
                        "price_jpy": 12800,
                        "seller": "example seller",
                        "url": "https://example.com/listing"
                      },
                      "freshness": "live_or_recent"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    },
    "/v1/full-intelligence": {
      "get": {
        "operationId": "fullIntelligence",
        "summary": "ANIME INTELLIGENCE Full Intelligence",
        "description": "Complete Japanese anime collectibles intelligence in one paid call: resolve the exact item, estimate current market value, assess rarity and rerelease or replenishment risk, flag authenticity concerns, decide BUY/WAIT/WATCH/AVOID and return the best current purchase route. Covers figures, plush, acrylic goods, keychains, badges, lottery prizes, model kits, trading cards, collaboration sneakers and apparel. WHEN TO USE: Use when the agent needs identity, market value, rarity, authenticity risk, BUY-WAIT and best purchase route together for figures, character goods, cards, collaboration sneakers or apparel.",
        "tags": [
          "anime-collectibles",
          "japanese-character-goods",
          "anime-merchandise",
          "collectibles-intelligence",
          "collectible-valuation",
          "market-value",
          "resale-value",
          "rarity",
          "authenticity",
          "buy-or-wait",
          "where-to-buy",
          "shopping-agent",
          "purchase-decision"
        ],
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "description": "Product name, JAN/EAN-13, model number or other identifying description. Use either query or id.",
            "schema": {
              "type": "string"
            },
            "examples": {
              "primary": {
                "value": "Full intelligence for Nendoroid Hatsune Miku"
              },
              "secondary": {
                "value": "Is this ONE PIECE collectible worth buying and where?"
              }
            }
          },
          {
            "in": "query",
            "name": "id",
            "description": "ANIME INTELLIGENCE canonical product UUID. Use either id or query.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "in": "query",
            "name": "lang",
            "schema": {
              "type": "string",
              "enum": [
                "ja",
                "en",
                "zh",
                "ko"
              ]
            },
            "example": "en"
          },
          {
            "in": "query",
            "name": "refresh",
            "description": "Set to 1 to explicitly request a live market refresh where supported.",
            "schema": {
              "type": "string",
              "enum": [
                "0",
                "1"
              ]
            }
          }
        ],
        "x-agent-intent": "Make one end-to-end valuation, risk, timing and purchase-route decision for a Japanese anime collectible.",
        "x-when-to-use": "Use when the agent needs identity, market value, rarity, authenticity risk, BUY-WAIT and best purchase route together for figures, character goods, cards, collaboration sneakers or apparel.",
        "x-value": "complete_collectible_intelligence",
        "x-output-fields": [
          "identity",
          "product type",
          "market",
          "rarity",
          "rerelease or replenishment status",
          "authenticity risk",
          "BUY-WAIT",
          "best place",
          "purchase routing",
          "freshness"
        ],
        "x-payment-info": {
          "protocol": "x402",
          "protocols": [
            "x402"
          ],
          "version": 2,
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.05"
          },
          "price_usdc": 0.05,
          "price_atomic": "50000",
          "currency": "USDC",
          "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
        },
        "responses": {
          "200": {
            "description": "Paid intelligence response after x402 settlement",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "service": {
                      "type": "string",
                      "const": "ANIME INTELLIGENCE"
                    },
                    "version": {
                      "type": "string"
                    },
                    "price_usdc_atomic": {
                      "type": "string"
                    },
                    "price_usdc": {
                      "type": "number"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "name_ja": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "name_en": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "manufacturer": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "jan_code": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "product_type": {
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "identification_confidence": {
                          "type": [
                            "number",
                            "null"
                          ]
                        }
                      }
                    },
                    "monetization": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "generated_at": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "format": "date-time"
                    }
                  },
                  "additionalProperties": true
                },
                "examples": {
                  "representative": {
                    "value": {
                      "service": "ANIME INTELLIGENCE",
                      "version": "3.3.2",
                      "endpoint": "/v1/full-intelligence",
                      "charged": true,
                      "product": {
                        "name_en": "Official Product Name",
                        "jan_code": "4580590123456"
                      },
                      "market": {
                        "lowest_price_jpy": 12800,
                        "median_price_jpy": 14200
                      },
                      "rarity": {
                        "level": "rare"
                      },
                      "authenticity_risk": {
                        "level": "low"
                      },
                      "buy_wait": {
                        "decision": "BUY"
                      },
                      "best_place": {
                        "source": "yahoo",
                        "price_jpy": 12800
                      },
                      "expected_fields": [
                        "identity",
                        "product type",
                        "market",
                        "rarity",
                        "rerelease or replenishment status",
                        "authenticity risk",
                        "BUY-WAIT",
                        "best place",
                        "purchase routing",
                        "freshness"
                      ]
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "x402 payment required. The response contains payment requirements for Solana USDC."
          },
          "404": {
            "description": "Product could not be resolved before payment; charged=false."
          },
          "503": {
            "description": "Payment infrastructure or required configuration is unavailable."
          }
        }
      }
    }
  }
}