NAV
Im token logo imToken API Documentation DApp-SDK Tokenlon-Onboarding Tokenlon-MMSK Tokenlon-MMProxy Tokenlon-JSSDK Tokenlon-Open-API
  • Endpoint
  • RPC APIs
  • Restful APIs
  • Supported tokens info
  • English

    We provide both rpc and restful APIs.

    Endpoint

    RPC:

    https://tokenlon-core-market.tokenlon.im/rpc

    Restful:

    https://tokenlon-core-market.tokenlon.im/rest

    RPC APIs

    getMarket

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
        "jsonrpc": "2.0",
        "method": "market.getMarket",
        "params": {},
        "id": 1
    }'
    

    Request Parameter

    none

    example result

    {
        "jsonrpc": "2.0",
        "result": [
            {
                "timestamp": 0,
                "pairs": "ATOM_ETH",
                "baseSymbol": "ATOM",
                "baseAddress": "0xc5637328da2e0a3400274a4088cea2e25fb91446",
                "baseDecimals": 6,
                "quoteSymbol": "ETH",
                "quoteAddress": "0x0000000000000000000000000000000000000000",
                "quoteDecimals": 18,
                "last": 0,
                "high24h": 0,
                "low24h": 0,
                "ask": 0.0208170000,
                "mid": 0.0208170000,
                "bid": 0,
                "vol24h": 0,
                "txs24h": 0,
                "wallet24h": 0,
                "change24h": 0
            },
            // ...
    }
    

    Request return

    market[], array, market summary

    Name Type Description
    timestamp Number data generate timestamp
    pairs String request pair
    baseSymbol String this pair base token symbol
    baseAddress String this pair base token address
    baseDecimals String this pair base token decimals
    quoteSymbol String this pair quote token symbol
    quoteAddress String this pair quote token address
    quoteDecimals String this pair quote token decimals
    last Number last trade price
    high24h Number highest price within 24H
    low24 Number lowest price within 24H
    ask Number current ask price
    mid Number (ask + mid) / 2
    bid Number current bid price
    vol24h Number total base trade vol within 24H
    txs24h Number total transactions within 24H
    wallet24h Number total wallets trade within 24H
    change24h Number price changed compared with yesterday

    getTokens

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
        "jsonrpc": "2.0",
        "method": "market.getTokens",
        "params": {},
        "id": 1
    }'
    

    Request Parameter

    none

    example result

    {
        "jsonrpc": "2.0",
        "result": [
            {
                "symbol": "ATOM",
                "contractAddress": "0xc5637328da2e0a3400274a4088cea2e25fb91446",
                "decimals": 6
            },
            // ...
    }
    

    Request return

    token[], array, every token info

    Name Type Description
    symbol String token symbol
    contractAddress String token contract address
    decimals Number token decimals

    getPairs

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
        "jsonrpc": "2.0",
        "method": "market.getPairs",
        "params": {},
        "id": 1
    }'
    

    Request Parameter

    none

    example result

    {
      "jsonrpc": "2.0",
      "result": [
          "ATOM_ETH",
          "ATOM_USDT",
          "DAI_ETH",
          // ...
      ],
      "id": 1
    }
    

    Request return

    string[], array, every item is pair string

    getTicker

    Get ticker by pairs and period

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
      "jsonrpc": "2.0",
      "method": "market.getTicker",
      "params": {
        "pairs": "USDT_ETH",
        "period": "7D"
      },
      "id":1
    }'
    

    Request Parameter

    Name Type Mandatory Description
    pairs String YES pairs list on getPairs API response, like DAI_ETH
    period String YES "24H", "7D", "1M"

    example result

    {
      "jsonrpc": "2.0",
      "result": {
        "timestamp": 1568779507,
        "period": "7D",
        "pairs": "USDT_ETH",
        "lastTimestamp": 1568778898,
        "last": 0.004738890000,
        "high": 0.005741520000,
        "low": 0.004655610000,
        "ask": 0.0047321598,
        "mid": 0.0047303299,
        "bid": 0.0047285,
        "vol": 1803272.382003000000,
        "txs": 3146,
        "wallet": 2195,
        "change": -0.0117
      },
      "id": 1
    }
    

    Request return

    Name Type Description
    timestamp Number ticker generate timestamp
    period String request period
    pairs String request pair
    lastTimestamp Number this pair last trade timestamp
    last Number last trade price
    high Number highest price within period
    low Number lowest price within period
    ask Number current ask price
    mid Number (ask + mid) / 2
    bid Number current bid price
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period
    change Number price changed compared with yesterday

    getTickerHistory

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
      "jsonrpc": "2.0",
      "method": "market.getTickerHistory",
      "params": {
        "pairs": "DAI_ETH",
        "beginTimestamp": 1569456000,
        "endTimestamp": 1569542400
      },
      "id":1
    }'
    

    Request Parameter

    Name Type Mandatory Description
    pairs String YES pairs list on getPairs API response, like DAI_ETH
    beginTimestamp Number YES Query begin Unix Timestamp, like 1568937600
    endTimestamp Number YES Query end Unix Timestamp

    example result

    {
        "jsonrpc": "2.0",
        "result": [
            {
                "date": "2019-09-27",
                "period": "24H",
                "pairs": "DAI_ETH",
                "last": 0.006011889912,
                "high": 0.006159923819,
                "low": 0.006011889912,
                "vol": 4146.066485000000,
                "txs": 14,
                "wallet": 11
            },
            {
                "date": "2019-09-26",
                "period": "24H",
                "pairs": "DAI_ETH",
                "last": 0.006074829999,
                "high": 0.006406060851,
                "low": 0.005915320000,
                "vol": 6996.547560420000,
                "txs": 11,
                "wallet": 9
            }
        ],
        "id": 1
    }
    

    Request return

    ticker[], array, order by date desc

    Name Type Description
    date string ticker date, like 2019-09-27
    period String 24H
    pairs String request pair
    last Number last trade price
    high Number highest price within period
    low Number lowest price within period
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period

    getTradeCap

    Get trade market cap by currency and period

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
      "jsonrpc": "2.0",
      "method": "market.getTradeCap",
      "params": {
        "currency": "USD",
        "period": "1M"
      },
      "id":1
    }'
    

    Request Parameter

    Name Type Mandatory Description
    currency String YES "ETH", "USD", "CNY", "DAI"
    period String YES "24H", "7D", "1M"

    example result

    {
      "jsonrpc": "2.0",
      "result": {
        "timestamp": 1568780268,
        "period": "24H",
        "vol": 466504.0822626114,
        "txs": 627,
        "wallet": 499,
        "currency": "USD"
      },
      "id": 1
    }
    

    Request return

    Name Type Description
    timestamp Number data generated timestamp
    period String request period
    vol Number total vol based on currency within 24H
    txs Number total txs within 24H
    wallet Number total wallets trade within 24H
    currency String request currency

    getTradeCapHistory

    Request mode

    POST

    example call

    curl -X POST \
      https://tokenlon-core-market.tokenlon.im/rpc \
      -H 'Content-Type: application/json' \
      -H 'cache-control: no-cache' \
      -d '{
      "jsonrpc": "2.0",
      "method": "market.getTradeCapHistory",
      "params": {
        "beginTimestamp": 1569456000,
        "endTimestamp": 1569542400,
        "currency": "USD"
      },
      "id":1
    }'
    

    Request Parameter

    Name Type Mandatory Description
    beginTimestamp Number YES Query begin Unix Timestamp, like 1568937600
    endTimestamp Number YES Query end Unix Timestamp
    currency String YES "ETH", "USD", "CNY", "DAI"

    example result

    {
        "jsonrpc": "2.0",
        "result": [
            {
                "date": "2019-09-27",
                "period": "24H",
                "vol": 706408.8389006486,
                "txs": 367,
                "wallet": 278,
                "currency": "USD"
            },
            {
                "date": "2019-09-26",
                "period": "24H",
                "vol": 337192.6146473213,
                "txs": 345,
                "wallet": 286,
                "currency": "USD"
            }
        ],
        "id": 1
    }
    

    Request return

    tradeCap[], array, order by date desc

    Name Type Description
    date string ticker date, like 2019-09-27
    period String 24H
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period
    currency String request currency

    Restful APIs

    get_market

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_market'
    

    Request Parameter

    none

    example result

    {
        "error": false,
        "data": [
            {
                "timestamp": 0,
                "pairs": "ATOM_ETH",
                "baseSymbol": "ATOM",
                "baseAddress": "0xc5637328da2e0a3400274a4088cea2e25fb91446",
                "baseDecimals": 6,
                "quoteSymbol": "ETH",
                "quoteAddress": "0x0000000000000000000000000000000000000000",
                "quoteDecimals": 18,
                "last": 0,
                "high24h": 0,
                "low24h": 0,
                "ask": 0.0207750000,
                "mid": 0.0207750000,
                "bid": 0,
                "vol24h": 0,
                "txs24h": 0,
                "wallet24h": 0,
                "change24h": 0
            },
            // ...
    }
    

    Request return

    market[], array, market summary

    Name Type Description
    timestamp Number data generate timestamp
    pairs String request pair
    baseSymbol String this pair base token symbol
    baseAddress String this pair base token address
    baseDecimals String this pair base token decimals
    quoteSymbol String this pair quote token symbol
    quoteAddress String this pair quote token address
    quoteDecimals String this pair quote token decimals
    last Number last trade price
    high24h Number highest price within 24H
    low24 Number lowest price within 24H
    ask Number current ask price
    mid Number (ask + mid) / 2
    bid Number current bid price
    vol24h Number total base trade vol within 24H
    txs24h Number total transactions within 24H
    wallet24h Number total wallets trade within 24H
    change24h Number price changed compared with yesterday

    get_tokens

    Request mode

    POST

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_tokens'
    

    Request Parameter

    none

    example result

    {
        "error": false,
        "data": [
            {
                "symbol": "ATOM",
                "contractAddress": "0xc5637328da2e0a3400274a4088cea2e25fb91446",
                "decimals": 6
            },
            // ...
    }
    

    Request return

    token[], array, every token info

    Name Type Description
    symbol String token symbol
    contractAddress String token contract address
    decimals Number token decimals

    get_pairs

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_pairs'
    

    Request Parameter

    none

    example result

    {
      "error": false,
      "data": [
          "ATOM_ETH",
          "ATOM_USDT",
          "DAI_ETH",
          // ...
      ]
    }
    

    Request return

    string[], array, every item is pair string

    get_ticker

    Get ticker by pairs and period

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_ticker?period=24H&pairs=USDT_ETH'
    

    Request Parameter

    Name Type Mandatory Description
    pairs String YES pairs list on get_pairs API response, like DAI_ETH
    period String YES "24H", "7D", "1M"

    example result

    {
     "error": false,
     "data": {
      "timestamp": 1577258730,
      "period": "24H",
      "pairs": "USDT_ETH",
      "lastTimestamp": 1577257908,
      "last": 0.008018935379,
      "high": 0.008018935379,
      "low": 0.007718990000,
      "ask": 0.0080012902,
      "mid": 0.0079947301,
      "bid": 0.00798817,
      "vol": 409760.423996000000,
      "txs": 124,
      "wallet": 81,
      "change": 0.0260
     }
    }
    

    Request return

    Name Type Description
    timestamp Number ticker generate timestamp
    period String request period
    pairs String request pair
    lastTimestamp Number this pair last trade timestamp
    last Number last trade price
    high Number highest price within period
    low Number lowest price within period
    ask Number current ask price
    mid Number (ask + mid) / 2
    bid Number current bid price
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period
    change Number price changed compared with yesterday

    get_ticker_history

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_ticker_history?pairs=DAI_ETH&beginTimestamp=1569456000&endTimestamp=1569542400'
    

    Request Parameter

    Name Type Mandatory Description
    pairs String YES pairs list on get_pairs API response, like DAI_ETH
    beginTimestamp Number YES Query begin Unix Timestamp, like 1568937600
    endTimestamp Number YES Query end Unix Timestamp

    example result

    {
     "error": false,
     "data": [
      {
       "date": "2019-09-27",
       "period": "24H",
       "pairs": "DAI_ETH",
       "last": 0.006011889912,
       "high": 0.006159923819,
       "low": 0.006011889912,
       "vol": 4146.066485000000,
       "txs": 14,
       "wallet": 11
      },
      {
       "date": "2019-09-26",
       "period": "24H",
       "pairs": "DAI_ETH",
       "last": 0.006074829999,
       "high": 0.006406060851,
       "low": 0.005915320000,
       "vol": 6996.547560420000,
       "txs": 11,
       "wallet": 9
      }
     ]
    }
    

    Request return

    ticker[], array, order by date desc

    Name Type Description
    date string ticker date, like 2019-09-27
    period String 24H
    pairs String request pair
    last Number last trade price
    high Number highest price within period
    low Number lowest price within period
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period

    get_trade_cap

    Get trade market cap by currency and period

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_trade_cap?currency=USD&period=1M'
    

    Request Parameter

    Name Type Mandatory Description
    currency String YES "ETH", "USD", "CNY", "DAI"
    period String YES "24H", "7D", "1M"

    example result

    {
     "error": false,
     "data": {
      "timestamp": 1577259148,
      "period": "1M",
      "vol": 17208235.4124141616,
      "txs": 8910,
      "wallet": 3063,
      "currency": "USD"
     }
    }
    

    Request return

    Name Type Description
    timestamp Number data generated timestamp
    period String request period
    vol Number total vol based on currency within 24H
    txs Number total txs within 24H
    wallet Number total wallets trade within 24H
    currency String request currency

    get_trade_cap_history

    Request mode

    GET

    example call

    curl 'https://tokenlon-core-market.tokenlon.im/rest/get_trade_cap_history?currency=USD&beginTimestamp=1569456000&endTimestamp=1569542400'
    

    Request Parameter

    Name Type Mandatory Description
    beginTimestamp Number YES Query begin Unix Timestamp, like 1568937600
    endTimestamp Number YES Query end Unix Timestamp
    currency String YES "ETH", "USD", "CNY", "DAI"

    example result

    {
     "error": false,
     "data": [
      {
       "date": "2019-09-27",
       "period": "24H",
       "vol": 706408.8389006486,
       "txs": 367,
       "wallet": 278,
       "currency": "USD"
      },
      {
       "date": "2019-09-26",
       "period": "24H",
       "vol": 337192.6146473213,
       "txs": 345,
       "wallet": 286,
       "currency": "USD"
      }
     ]
    }
    

    Request return

    tradeCap[], array, order by date desc

    Name Type Description
    date string ticker date, like 2019-09-27
    period String 24H
    vol Number total base trade vol within period
    txs Number total transactions within period
    wallet Number total wallets trade within period
    currency String request currency

    Supported tokens info

    You should notice that EOS and ATOM are just virtual erc20 Token, we only support some other token to exchange EOS and ATOM, then we will transfer the true EOS / ATOM from EOS / COSMOS network to user's EOS account name / COSMOS address based on the amount trade on ethereum.

    supported tokens

    [{
      "symbol": "ETH",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/eth%403x-2.png",
      "contractAddress": "0x0000000000000000000000000000000000000000",
      "info": "https://token-profile.token.im/token/ethereum?locale=en-US",
    },
    {
      "symbol": "ZRX",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/exchange-pairs/ZRX.png",
      "contractAddress": "0xe41d2489571d322189246dafa5ebde1f4699f498",
      "info": "https://token-profile.token.im/token/0xe41d2489571d322189246dafa5ebde1f4699f498?locale=en-US",
    },
    {
      "symbol": "DAI",
      "logo": "https://v2-cdn.token.im/app-mainnet-production/exchange-pairs/DAI.png",
      "contractAddress": "0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359",
      "info": "https://token-profile.token.im/token/0x89d24a6b4ccb1b6faa2625fe562bdd9a23260359?locale=en-US",
    },
    {
      "symbol": "KNC",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/exchange-pairs/kyber.png",
      "contractAddress": "0xdd974d5c2e2928dea5f71b9825b8b646686bd200",
      "info": "https://token-profile.token.im/token/0xdd974d5c2e2928dea5f71b9825b8b646686bd200?locale=en-US",
    },
    {
      "symbol": "OMG",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/omg.png",
      "contractAddress": "0xd26114cd6ee289accf82350c8d8487fedb8a0c07",
      "info": "https://token-profile.token.im/token/0xd26114cd6ee289accf82350c8d8487fedb8a0c07?locale=en-US",
    },
    {
      "symbol": "SNT",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/snt.png",
      "contractAddress": "0x744d70fdbe2ba4cf95131626614a1763df805b9e",
      "info": "https://token-profile.token.im/token/0x744d70fdbe2ba4cf95131626614a1763df805b9e?locale=en-US",
    },
    {
      "symbol": "MANA",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/mana%403x.png",
      "contractAddress": "0x0f5d2fb29fb7d3cfee444a200298f468908cc942",
      "info": "https://token-profile.token.im/token/0x0f5d2fb29fb7d3cfee444a200298f468908cc942?locale=en-US",
    },
    {
      "symbol": "USDC",
      "logo": "https://v2-cdn.token.im/app-mainnet-production/tokens/icons/a0b86991c621_1545531580.png",
      "contractAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "info": "https://token-profile.token.im/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48?locale=en-US",
    },
    {
      "symbol": "ELF",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/aelf%403x.png",
      "contractAddress": "0xbf2179859fc6d5bee9bf9158632dc51678a4100e",
      "info": "https://token-profile.token.im/token/0xbf2179859fc6d5bee9bf9158632dc51678a4100e?locale=en-US",
    },
    {
      "symbol": "TUSD",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/tusd3x.png",
      "contractAddress": "0x0000000000085d4780b73119b644ae5ecd22b376",
      "info": "https://token-profile.token.im/token/0x0000000000085d4780b73119b644ae5ecd22b376?locale=en-US",
    },
    {
      "symbol": "USDT",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/USDT.png",
      "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "info": "https://token-profile.token.im/token/0xdac17f958d2ee523a2206206994597c13d831ec7?locale=en-US",
    },
    {
      "symbol": "PAX",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/pax.png",
      "contractAddress": "0x8e870d67f660d95d5be530380d0ec0bd388289e1",
      "info": "https://token-profile.token.im/token/0x8e870d67f660d95d5be530380d0ec0bd388289e1?locale=en-US",
    },
    {
      "symbol": "USDX",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/USDX3.png",
      "contractAddress": "0xeb269732ab75a6fd61ea60b06fe994cd32a83549",
      "info": "https://token-profile.token.im/token/0xeb269732ab75a6fd61ea60b06fe994cd32a83549?locale=en-US",
    },
    {
      "symbol": "LOOM",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/LOOM.png",
      "contractAddress": "0xa4e8c3ec456107ea67d3075bf9e3df3a75823db0",
      "info": "https://token-profile.token.im/token/0xa4e8c3ec456107ea67d3075bf9e3df3a75823db0?locale=en-US",
    },
    {
      "symbol": "ENJ",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/ENJ.png",
      "contractAddress": "0xf629cbd94d3791c9250152bd8dfbdf380e2a3b9c",
      "info": "https://token-profile.token.im/token/0xf629cbd94d3791c9250152bd8dfbdf380e2a3b9c?locale=en-US",
    },
    {
      "symbol": "MIX",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/MIX1.png",
      "contractAddress": "0x5d285f735998f36631f678ff41fb56a10a4d0429",
      "info": "https://token-profile.token.im/token/0x5d285f735998f36631f678ff41fb56a10a4d0429?locale=en-US",
    },
    {
      "symbol": "HT",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/HT.png",
      "contractAddress": "0x6f259637dcd74c767781e37bc6133cd6a68aa161",
      "info": "https://token-profile.token.im/token/0x6f259637dcd74c767781e37bc6133cd6a68aa161?locale=en-US",
    },
    
    // warning, pls flow notice above
    {
      "symbol": "ATOM",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/icons/ATOM.png",
      "info": "https://token-profile.token.im/token/cosmos?locale=en-US",
    },
    {
      "symbol": "EOS",
      "logo": "https://aws-v2-cdn.token.im/app-mainnet-production/tokens/upload/eosLogo%403x.png",
      "info": "https://token-profile.token.im/token/eos?locale=en-US",
    }]