Get Token by Address - Akka Swap — Swap Tokens at Superior Prices

Get token information by contract address

curl --request GET \
  --url https://api.akka.finance/{chainId}/tokens/{address} \
  --header 'apikey: <api-key>'

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.akka.finance/{chainId}/tokens/{address}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "symbol": "UNI",
  "name": "Uniswap",
  "decimals": 18,
  "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
  "logoUri": "https://tokens.1inch.io/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984.png",
  "verified": true,
  "buyPriceUsd": 3.45,
  "sellPriceUsd": 3.44
}

{
  "statusCode": 400,
  "message": "Not enough balance. Current balance: 500000000000000000",
  "error": "Bad Request",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "path": "/partner/v1/999/quote"
}

{
  "statusCode": 400,
  "message": "Not enough balance. Current balance: 500000000000000000",
  "error": "Bad Request",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "path": "/partner/v1/999/quote"
}

GET

/

{chainId}

/

tokens

/

{address}

Get token information by contract address

curl --request GET \
  --url https://api.akka.finance/{chainId}/tokens/{address} \
  --header 'apikey: <api-key>'

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.akka.finance/{chainId}/tokens/{address}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "symbol": "UNI",
  "name": "Uniswap",
  "decimals": 18,
  "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
  "logoUri": "https://tokens.1inch.io/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984.png",
  "verified": true,
  "buyPriceUsd": 3.45,
  "sellPriceUsd": 3.44
}

{
  "statusCode": 400,
  "message": "Not enough balance. Current balance: 500000000000000000",
  "error": "Bad Request",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "path": "/partner/v1/999/quote"
}

{
  "statusCode": 400,
  "message": "Not enough balance. Current balance: 500000000000000000",
  "error": "Bad Request",
  "timestamp": "2024-01-01T12:00:00.000Z",
  "path": "/partner/v1/999/quote"
}

Use this endpoint to look up a specific token’s metadata when you already have its contract address. Returns the same data as the token list endpoint, but for a single token.

Authorizations

apikey

string

header

default:basic-test-key

required

API key. basic-test-key is a shared, rate-limited evaluation credential; use a dedicated key in production.

Path Parameters

address

string

required

Smart contract address of the token (checksummed EVM address format)

Example:

"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb"

chainId

number

required

Blockchain network identifier (999=HyperEVM, 1116=Core, 50=XDC, 223=B2, 200901=Bitlayer, 4200=Merlin, 60808=BOB)

Example:

999

Response

Successfully retrieved detailed token information including metadata and trading data

symbol

string

required

Token symbol

Example:

"UNI"

name

string

required

Token name

Example:

"Uniswap"

decimals

number

required

Token decimals

Example:

18

address

string

required

Token contract address

Example:

"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984"

logoUri

object

required

Token logo URI

Example:

"https://tokens.1inch.io/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984.png"

verified

boolean

required

Whether token is verified

Example:

true

buyPriceUsd

object | null

Price to buy 1 unit of the token (USD)

Example:

3.45

sellPriceUsd

object | null

Price to sell 1 unit of the token (USD)

Example:

3.44