# Steem Developer Portal

Used to lookup market history information. These AppBase API methods are still under development and subject to change.

- Working on mainnet
- Working on testnet

#### market_history_api.get_market_history

Returns the market history for the internal SBD:STEEM market.

##### Query Parameters JSON

    {
      "bucket_seconds": 0,
      "start": "1970-01-01T00:00:00",
      "end": "1970-01-01T00:00:00"
    }

##### Expected Response JSON

    {"buckets": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":15,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":60,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":300,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":3600,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":86400,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_market_history_buckets

Returns the bucket seconds being tracked by the plugin.

##### Query Parameters JSON

    {}

##### Expected Response JSON

    {"bucket_sizes": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history_buckets", "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_order_book

Returns the internal market order book.

##### Query Parameters JSON

    {"limit": 500}

##### Expected Response JSON

    {"bids": [], "asks": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_order_book", "params":{"limit":10}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_order_book", "params":{"limit":50}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_recent_trades

Returns the most recent trades for the internal SBD:STEEM market.

##### Query Parameters JSON

    {"limit": 1000}

##### Expected Response JSON

    {"trades": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_recent_trades", "params":{"limit":10}, "id":1}' https://api.steemit.com

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_recent_trades", "params":{"limit":500}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_ticker

Returns the market ticker for the internal SBD:STEEM market.

##### Query Parameters JSON

    {}

##### Expected Response JSON

    {
      "latest": "0.00000000000000000",
      "lowest_ask": "0.00000000000000000",
      "highest_bid": "0.00000000000000000",
      "percent_change": "0.00000000000000000",
      "steem_volume": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "sbd_volume": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      }
    }

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_ticker", "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_trade_history

Returns the trade history for the internal SBD:STEEM market.

##### Query Parameters JSON

    {
      "start": "1970-01-01T00:00:00",
      "end": "1970-01-01T00:00:00",
      "limit": 1000
    }

##### Expected Response JSON

    {"trades": []}

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_trade_history", "params":{"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00","limit":10}, "id":1}' https://api.steemit.com

- Working on mainnet
- Working on testnet

#### market_history_api.get_volume

Returns the market volume for the past 24 hours.

##### Query Parameters JSON

    {}

##### Expected Response JSON

    {
      "steem_volume": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "sbd_volume": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      }
    }

##### Example `curl`

    curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_volume", "id":1}' https://api.steemit.com