API Documentation
GET /open/v1/{network_id}/orders

Obtain all listing orders of a contract, Can be filtered by token_id and maker.

Path parameters

  • network_id integer Required

    Chain ID.

    Value is 137.

Query parameters

  • contract string Required

    Address of the NFT contract

  • token_id string

    Token id of the NFT

  • maker string

    Address of orders' maker, aka seller.

  • only_dew integer

    Only return orders from dew marketplace. 1: yes, 0: no

    Values are 0 or 1. Default value is 1.

  • currency string

    Currency of the price

  • limit integer

    Default value is 20.

  • offset integer

    Default value is 0.

Responses

  • 200 application/json

    Successful

    Hide response attributes Show response attributes object
    • code integer Required

      0: success, others: error

    • data array[object] Required
      Hide data attributes Show data attributes object
      • source integer Required

        Market source. -2: Dew, 0: OpenSea, 4: Tofu, 5: Element, 6: MagicEden, 7: OnePlanet, 8: Mooar

        Values are -2, 1, 4, 5, 6, 7, or 8.

      • price string
      • currency string
      • price_usd number
      • id integer Required

        Unique id of each order

      • network_id integer Required

        Chain ID.

      • nft object | null
        Hide nft attributes Show nft attributes object | null
        • owner string | null
        • contract string
        • token_id string
        • name string | null
        • rank integer | null
        • status integer | null
      • contract object | null
        Hide contract attributes Show contract attributes object | null
        • contract string Required
        • name string Required
        • symbol string Required
        • icon_url string Required
        • slug string | null
        • verified boolean Required
        • show_rarity boolean
      • order_hash string Required

        Unique hash of each order

      • maker string

        Address of orders' maker, aka seller.

      • taker string
      • status integer Required

        -1: invalid, 0: list, 1: sold, 2: cancelled, 3: expired

      • created_at integer

        Timestamp of order creation

      • listed_at integer

        Timestamp of order listing

      • expired_at integer

        Timestamp of order expiration

      • is_offer boolean

        Whether the order is an offer

      • updated_at integer

        Timestamp of order update

      • amount string

        Amount of NFTs, only available for ERC1155

      • remain string

        Amount of NFTs that are not sold, only available for ERC1155

    • total integer
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • code integer Required

      0: success, others: error

    • error string | null Required
    • errors array[object] | null
GET /open/v1/{network_id}/orders 
curl \
 -X GET https://api.dewapi.com/open/v1/137/orders?contract=0xa131b877B12B0Ae8BB7da7229b8a1095881497A6 \
 -H "X-API-Key: $API_KEY"
Response examples (200) 
{
  "code": 0,
  "data": [
    {
      "source": 1,
      "price": "49000000000000000",
      "currency": "0x0000000000000000000000000000000000000000",
      "price_usd": "0.1",
      "id": 1,
      "network_id": 137,
      "nft": {
        "owner": "0x40415c1c0e7a8ff3e184b51a94a2fc5b92df9434",
        "contract": "0xa131b877B12B0Ae8BB7da7229b8a1095881497A6",
        "token_id": "1",
        "name": "BAYC #1",
        "rank": 1,
        "status": 0
      },
      "contract": {
        "contract": "0x8a90CAb2b38dba80c64b7734e58Ee1dB38B8992e",
        "name": "Doodle",
        "symbol": "DOODLE",
        "icon_url": "nfts/qt5xtfvkajlhva1.jpg",
        "slug": "doodles-official",
        "verified": true,
        "show_rarity": false
      },
      "order_hash": "0x41a2753400f805db148079f60355df470aece45941a45cb96a25ab5d24e4c243",
      "maker": "0x40415c1c0e7a8ff3e184b51a94a2fc5b92df9434",
      "taker": "string",
      "status": 0,
      "created_at": 1654983000,
      "listed_at": 1654983000,
      "expired_at": 1654999000,
      "is_offer": false,
      "updated_at": 1654983000,
      "amount": "1",
      "remain": "1"
    }
  ],
  "total": 0
}
Response examples (400) 
{
  "code": 3000,
  "error": "this is an error message",
  "errors": [
    {
      "field": [
        "error message"
      ]
    }
  ]
}