diff --git a/docs.json b/docs.json index d2b71bda..3a8a15ca 100644 --- a/docs.json +++ b/docs.json @@ -149,6 +149,7 @@ "references/api/get-chains", "references/api/get-chains-liquidity", "references/api/get-currencies-v2", + "references/api/get-currency-classifications", "references/api/get-token-price", "references/api/transactions-index", "references/api/transactions-single", diff --git a/references/api/api_core_concepts/fees.mdx b/references/api/api_core_concepts/fees.mdx index aefe040e..188e3c91 100644 --- a/references/api/api_core_concepts/fees.mdx +++ b/references/api/api_core_concepts/fees.mdx @@ -111,6 +111,8 @@ In any given token swap or bridge powered by Relay, there are four potential fee If you are interested in learning how app fees work, and how you can add them to your quotes please check out our [App Fees Doc](/features/app-fees). +To check how a token is classified programmatically, use [`GET /currencies/classifications`](/references/api/get-currency-classifications), which returns the current stable and major symbol lists; any token in neither list is treated as minor. + _Please note that the above fee structure applies to standard cases. In certain cases, such as route-specific campaigns or promotions, different fees may apply._ ## Fees in the API diff --git a/references/api/get-currency-classifications.mdx b/references/api/get-currency-classifications.mdx new file mode 100644 index 00000000..ddaf91a2 --- /dev/null +++ b/references/api/get-currency-classifications.mdx @@ -0,0 +1,9 @@ +--- +title: "Get Currency Classifications" +description: "Get the token symbols Relay classifies as stable or major for fee categories" +openapi: get /currencies/classifications +--- + + +The response lists the token symbols (lowercase) currently classified as **stable** and **major** — the live source of the fee-category lists in [Fees](/references/api/api_core_concepts/fees). There is no `minor` list: any token in neither array is treated as minor for fees. Classification is by symbol, not by contract address, and the lists can change as Relay adds tokens. +