Check token KYC permissions

For each token in the request, reports whether the token requires a permissioned adapter and whether the supplied walletAddress is allowlisted to trade it. If the token is permissioned but the wallet is not allowlisted, the response includes a kycUrl the wallet holder must complete to gain access. The request supports a maximum of 2 tokens.

Authorization

x-api-keystringrequiredheader

Playground key

You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.

Get your keys

Body

application/json

walletAddressstringrequired

The wallet address which will be used to send the token.

tokensstring[]required

Tokens to check permissions for. Maximum of 2 per request.

chainIdenumrequireddefault:1

1105613013714319632448018684217432646635042845310143421614222043114570735914481457777777713018453211155111

The unique ID of the blockchain. For a list of supported chains see the FAQ.

Response

Token permissions lookup successful.

requestIdstringrequired

A unique ID for the request.

resultsobject[]required

POST/permissions

Request

curl --request POST \
  --url 'https://trade-api.gateway.uniswap.org/v1/permissions' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "walletAddress": "<string>",
  "tokens": "<string[]>",
  "chainId": 1
}'

Response

200

{  "requestId": "<string>",  "results": [    {      "token": "<string>",      "isPermissioned": "<boolean>",      "isAllowlisted": "<boolean>",      "adapterTokenAddress": "<string>",      "kycUrl": "<string>",      "issuer": "<string>"    }  ]}