Giter VIP home page Giter VIP logo

swap-api's Introduction

Streetswap API

The Streetswap API is a set of endpoints used by market aggregators (e.g. coinmarketcap.com) to surface Thugswap liquidity and volume information. All information is fetched from the underlying subgraphs.

The API is designed around the CoinMarketCap requirements document.

Prefer the Thugswap subgraph for any Thugswap queries whenever possible.

Thugswap Subgraph: https://github.com/thugswap/thugswap-subgraph

Thugswap Endpoints

All Thugswap pairs consist of two different tokens. BNB is not a native currency in Thugswap, and is represented only by WBNB in the pairs.

The canonical WBNB address used by the Thugswap interface is 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c.

Returns data for the top ~1000 Thugswap pairs, sorted by reserves. Results are edge cached for 15 minutes.

Request

GET https://api.streetswap.vip/summary

Response

{
  "0x..._0x...": {                  // the asset ids of the BEP20 tokens (i.e. token addresses), joined by an underscore
    "last_price": "1.234",          // denominated in token0/token1
    "base_volume": "123.456",       // last 24h volume denominated in token0
    "quote_volume": "1234.56"       // last 24h volume denominated in token1
    "pair_liquidity": "1234.56"     // Pair liquidity in USD
  },
  // ...
}

Returns the total liquidity in USD value on Thugswap. Results are edge cached for 24 hours.

Request

GET https://api.streetswap.vip/totalliquidity

Response

{
  "result": {
    "totalLiquidityUSD": "...", // Total liquidity in USD
  }
}

Returns the tokens in the top ~1000 pairs on Thugswap, sorted by reserves. Results are edge cached for 24 hours.

Request

GET https://api.streetswap.vip/assets

Response

{
  // ...,
  "0x...": {              // the address of the BEP20 token
    "name": "...",        // not necesssarily included for BEP20 tokens
    "symbol": "...",      // not necesssarily included for BEP20 tokens
    "id": "0x...",        // the address of the BEP20 token
    "maker_fee": "0",     // always 0
    "taker_fee": "0.004", // always 0.004 i.e. .4%
  },
  // ...
}

Returns data for the top ~1000 Thugswap pairs, sorted by reserves. Results are edge cached for 1 minute.

Request

GET https://api.streetswap.vip/tickers

Response

{
  "0x..._0x...": {                    // the asset ids of BNB and BEP20 tokens, joined by an underscore
    "base_name": "...",             // token0 name
    "base_symbol": "...",           // token0 symbol
    "base_id": "0x...",             // token0 address
    "quote_name": "...",            // token1 name
    "quote_symbol": "...",          // token1 symbol
    "quote_id": "0x...",            // token1 address
    "last_price": "1.234",          // the mid price as token1/token0
    "base_volume": "123.456",       // denominated in token0
    "quote_volume": "1234.56"       // denominated in token1
  },
  // ...
}

/orderbook/:pair

Returns simulated orderbook data for the given Thugswap pair. Since Thugswap has a continuous orderbook, fixed amounts in an interval are chosen for bids and asks, and prices are derived from the Thugswap formula (accounting for both slippage and fees paid to LPs). Results are edge cached for 15 minutes.

Request

GET https://api.streetswap.vip/orderbook/:pair

URL Parameters

  • pair: The asset ids of two BEP20 tokens, joined by an underscore, e.g. 0x..._0x.... The first token address is considered the base in the response.

Response

{
  "timestamp": 1234567, // UNIX timestamp of the response
  "bids": [
    ["12", "1.2"],      // denominated in base token, quote token/base token
    ["12", "1.1"],      // denominated in base token, quote token/base token
    // ...
  ],
  "asks": [
    ["12", "1.3"],      // denominated in base token, quote token/base token
    ["12", "1.4"],      // denominated in base token, quote token/base token
    // ...
  ]
}

/trades/:pair

Returns all swaps in the last 24 hours for the given Thugswap pair. Results are edge cached for 15 minutes.

The pair address is the address of the two tokens in either order. The first address is considered the base in the response.

Note because Thugswap supports flash swaps and borrowing of both tokens in a pair, you may wish to exclude these trade types (types "???" and "borrow-both").

URL Parameters

  • pair: The asset ids of two BEP20 tokens, joined by an underscore, e.g. 0x..._0x.... The first token address is considered the base in the response.

Request

GET https://api.streetswap.vip/trades/:pair

Response

[
  {
    "trade_id": "...",
    "price": "1.234",           // denominated in quote token/base token
    "base_volume": "123.456",   // denominated in base token
    "quote_volume": "1234.56",  // denominated in quote token
    "trade_timestamp": 1234567, // UNIX timestamp
    "type": "buy"               // "buy"/"sell"/"borrow-both"/"???"
  },
  // ...
]

the end.

swap-api's People

Contributors

theothug avatar pppest avatar dependabot[bot] avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.