Get Custom Token

Get metadata of a custom token

Custom Token API

Provides token details for a user-specified token that is not included in Rango's official list. Currently supports blockchains based on Solana and EVM.

const tokenResponse = await rango.getCustomToken({
    "blockchain": "SOLANA", 
    "address": "3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA"
})

const response = await axios.get('https://api.rango.exchange/meta/custom-token', {
  params: {
    'blockchain': 'SOLANA',
    'address': '3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA',
    'apiKey': 'c6381a79-2817-4602-83bf-6a641a409e32'
  }
});

Custom Token Request

blockchain* String
- Description: The blockchain which the token belongs to.
- Example: SOLANA
address* String
- Description: Smart contract address of the token.
- Example: 3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA

Custom Token Response

token
- Description: The token's metadata
error
- Description: Error message if there was any problem
errorCode
- Description: Error code if there was any problem
traceId
- Description: Trace id help Rango support to resolve the issue

export type CustomTokenResponse = {
  token: Token
  error: string | null
  errorCode: number | null
  traceId: number | null
}

export type Token = {
  blockchain: string
  address: string | null
  symbol: string
  name: string | null
  decimals: number
  image: string
  usdPrice: number | null
  isSecondaryCoin: boolean
  coinSource: string | null
  coinSourceUrl: string | null
  isPopular: boolean
  supportedSwappers?: string[]
}

{
  "token": {
    "blockchain": "SOLANA",
    "symbol": "Brett",
    "image": "https://bafkreifi5rkzrqyze3cqoqt5xm6ullqpyh5g52ut46pmwva6cju2yyy3ay.ipfs.nftstorage.link",
    "address": "3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA",
    "usdPrice": null,
    "decimals": 9,
    "name": "Brett",
    "isPopular": false,
    "isSecondaryCoin": true,
    "coinSource": null,
    "coinSourceUrl": null,
    "supportedSwappers": []
  },
  "error": null,
  "errorCode": null,
  "traceId": null
}

PreviousReport Transaction Failure NextGet Address Token Balance

Last updated 1 year ago

Was this helpful?