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.

Typescript (SDK)

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

Node.js (Axios)

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

Bash (cURL)

curl --request GET \
     --url 'https://api.rango.exchange/basic/meta/custom-token?blockchain=SOLANA&address=3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA&apiKey=c6381a79-2817-4602-83bf-6a641a409e32'

Custom tokenrango-exchange

Custom Token Swagger

Custom Token Request

API Definition

• blockchain* String

  • Description: The blockchain which the token belongs to.

  • Example: SOLANA

• address* String

  • Description: Smart contract address of the token.

  • Example: 3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA

SDK Models (Typescript)

export type CustomTokenRequest = {
  blockchain: string
  address: string
}

Custom Token Response

API Definition

• 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

SDK Models (Typescript)

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

export type Token = {
  blockchain: string
  chainId: string | null
  address: string | null
  symbol: string
  name: string | null
  decimals: number
  image: string
  blockchainImage: string
  usdPrice: number | null
  isPopular: boolean
  supportedSwappers: string[]
}

Sample Response

{
  "token": {
    "blockchain": "SOLANA",
    "symbol": "Brett",
    "name": "Brett",
    "isPopular": false,
    "chainId": "mainnet-beta",
    "address": "3yoMkf3X6bDxjks6YaWwNk4SAbuaysLg1a4BjQKToQAA",
    "decimals": 9,
    "image": "https://bafkreifi5rkzrqyze3cqoqt5xm6ullqpyh5g52ut46pmwva6cju2yyy3ay.ipfs.nftstorage.link",
    "blockchainImage": "https://raw.githubusercontent.com/rango-exchange/assets/main/blockchains/SOLANA/icon.svg",
    "usdPrice": 0.09683140474717515,
    "supportedSwappers": []
  },
  "error": null,
  "errorCode": null,
  "traceId": null
}