Offer's JSON structure and fields description
Blockchain can keep hundreds of thousands of offers and fetching a particular set of offers need to have a filtering mechanism. Zano daemon has a built-in effective search engine, which car represents marketplace offers in a few different orders, with wide filtering options provided in this structure.
od: {
"offset": 0,
"limit": 100,
"amount_low_limit": 0,
"amount_up_limit": 0,
"category": "",
"keyword": "",
"location_city": "",
"location_country": "",
"offer_type_mask": 0,
"order_by": 0,
"primary": "",
"rate_low_limit": "0.000000",
"rate_up_limit": "0.000000",
"reverse": false,
"target": "",
"timestamp_start": 0,
"timestamp_stop": 0
}
Fields description:
- order_by - chose in how to order offers in selection. At this moment supported following ordering:
| "order_by" value | Order Type |
|---|---|
| 0 | Order by timestamp (most usable) |
| 1 | Order by an amount of Zano |
| 2 | Order by the amount of specified currency |
| 3 | Order by rate, which calculated as the amount currency divided to amount Zano |
| 4 | Order by payment type(as string) |
| 5 | Order by contact field(as string) |
| 6 | Order by location: country string concatenated with city string |
| 7 | Order by target string, basically title string |
- reverse - Reverse order
- offset - Offeset regarding first item which fit specified filter, count include only items which fit the filter. Userful for enumeration big amount or records, up to whole offers database enumeration.
- limit - Maximum records to return.
- amount_low_limit - filter offers selection by field amount of specified currency at lower boundary.
- amount_up_limit - filter offers selection by field amoun of specified currency t at higher boundary.
- category - fiter by category, work's as substring matching, i.e. if categories set to "CLS:MAN:TSH" and filters category fileds set to "MAN" then it fits category condition.
- keyword - This use search by keyword throught the all fields.
- location_city - Used to filter by city name or geo-tag
- location_country - Filters by country code.
- offer_type_mask - Specify type of the offer:
| 0x00000001 | Offer type 0 (buy currency for Zano) |
| 0x00000002 | Offer type 1 (buy Zano for currency) |
| 0x00000004 | Offer type 2 (buy goods for Zano) |
| 0x00000008 | Offer type 3 (sell goods for Zano) |
- rate_low_limit - Filter by low limit of the rate between Zano and currency amount currency divided to amount Zano)
- rate_up_limit - Filter by up limit of the rate between Zano and currency amount currency divided to amount Zano)
- target - Basically a title for subject of the Offer - could be the name of the goods or currency which supposed to be traded.
- timestamp_start - Setup a lower timestamp boundary. Useful if the offers are selecting for given time range.
- timestamp_stop - Setup a higher timestamp boundary. Useful if the offers are selecting for given time range.