⚙️API

Documentation

All JamonSwap pairs consist of two different tokens. MATIC is not a native currency in JamonSwap, and is represented only by WMATIC in the pairs.

The canonical WMATIC address used by the JamonSwap interface is 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c.

Results are cached for 5 minutes (or 300 seconds).

/summary

Returns data for the top ~1000 JamonSwap pairs, sorted by reserves.

Request

GET https://api.JamonSwap.finance/api/summary

Response

{
  "updated_at": 1234567,              // UNIX timestamp
  "data": {
    "0x..._0x...": {                  // ERC20 token addresses, joined by an underscore
      "price": "...",                 // price denominated in token1/token0
      "base_volume": "...",           // last 24h volume denominated in token0
      "quote_volume": "...",          // last 24h volume denominated in token1
      "liquidity": "...",             // liquidity denominated in USD
      "liquidity_MATIC": "..."          // liquidity denominated in MATIC
    },
    // ...
  }
}

/tokens

Returns the tokens in the top ~1000 pairs on JamonSwap, sorted by reserves.

Request

GET https://api.JamonSwap.finance/api/tokens

Response

{
  "updated_at": 1234567,              // UNIX timestamp
  "data": {
    "0x...": {                        // the address of the ERC20 token
      "name": "...",                  // not necessarily included for ERC20 tokens
      "symbol": "...",                // not necessarily included for ERC20 tokens
      "price": "...",                 // price denominated in USD
      "price_MATIC": "...",             // price denominated in MATIC
    },
    // ...
  }
}

/tokens/0x...

Returns the token information, based on address.

Request

GET https://api.JamonSwap.finance/api/tokens/0x2594C5B25EdAb3eBe937e27650c02922D9A62BF2

Response

{
  "updated_at": 1234567,              // UNIX timestamp
  "data": {
    "name": "...",                    // not necessarily included for ERC20 tokens
    "symbol": "...",                  // not necessarily included for ERC20 tokens
    "price": "...",                   // price denominated in USD
    "price_MATIC": "...",               // price denominated in MATIC
  }
}

/pairs

Returns data for the top ~1000 JamonSwap pairs, sorted by reserves.

Request

GET https://api.JamonSwap.finance/api/pairs

Response

{
  "updated_at": 1234567,              // UNIX timestamp
  "data": {
    "0x..._0x...": {                  // the asset ids of MATIC and ERC20 tokens, joined by an underscore
      "pair_address": "0x...",        // pair address
      "base_name": "...",             // token0 name
      "base_symbol": "...",           // token0 symbol
      "base_address": "0x...",        // token0 address
      "quote_name": "...",            // token1 name
      "quote_symbol": "...",          // token1 symbol
      "quote_address": "0x...",       // token1 address
      "price": "...",                 // price denominated in token1/token0
      "base_volume": "...",           // volume denominated in token0
      "quote_volume": "...",          // volume denominated in token1
      "liquidity": "...",             // liquidity denominated in USD
      "liquidity_MATIC": "..."          // liquidity denominated in MATIC
    },
    // ...
  }
}