API Reference

Inputs

ListingsFilter

This input filters the listings return results by price, age, game, etc.

input ListingsFilter {
  asset_id: Int
  game_id: Int
  collection_id: Int
  marketplace_id: Int
  price_high: String
  price_low: String
  view: Int
  traits: [ListingsFilterTrait!]
}

Fields

ListingsFilter.asset_id Int

If set, only this asset's listings will be returned.

ListingsFilter.collection_id Int

If set, only this collection's listings will be returned.

ListingsFilter.game_id Int

If set, only this game's listings will be returned.

ListingsFilter.marketplace_id Int

If set, only this marketplace's listings will be returned.

ListingsFilter.price_high String

If set, only listings with a curr_price less than or equal to this amount will be returned. Must be sent in Ether notation (i.e. "1.57").

ListingsFilter.price_low String

If set, only listings with a curr_price greater than or equal to this amount will be returned. Must be sent in Ether notation (i.e. "1.57").

ListingsFilter.view Int

An integer denoting the view type or order of the listings returned. Values can be

{
  1: Price - Low to High // Orders by price ascending
  2: Price - High to Low // Order by price descending
  3: Recently Listed // Order by created date descending
  4: Oldest // Order by created date ascending
}

ListingsFilter.traits [ListingsFilterTrait!]

A list of ListingsFilterTrait input objects by which to filter the listings returned.

ListingsFilterTrait

This input is used to filter listings return data by trait. Used inside of ListingsFilter.

input ListingsFilterTrait {
  id: Int!
  values: [String!]
  range: [Float!]
}

Fields

ListingsFilterTrait.id Int!

The identifier of the trait to which to filter the listings return data.

ListingsFilterTrait.range [Float!]

An array of two floats representing the minimum and maximum (inclusive) of the trait's range to which to filter the listings return data. It should be sent in the format [min, max]. Note: Range and values cannot be used at the same time. The correct one to send is dependent on the trait in question.

ListingsFilterTrait.values [String!]

An array of strings representing the values of the trait to which to filter the listings return data. It should be sent in the format [value1, value2, ..., valueN]. Note: Range and values cannot be used at the same time. The correct one to send is dependent on the trait in question.