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.

If you are using Rango Public Test Api Key for testing the API, make sure to use "https://public-api.rango.exchange" for endpoint calls. If you have access to a Private API Key, you must use "https://api.rango.exchange"

Typescript (SDK)

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

Node.js (Axios)

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

Bash (cURL)

curl --request GET \
     --url 'https://public-api.rango.exchange/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
  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[]
}

Sample Response

{
  "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
}