Skip to content

Latest commit

 

History

History
35 lines (28 loc) · 3.36 KB

README.md

File metadata and controls

35 lines (28 loc) · 3.36 KB

Market Streamer

Build Status Go Report Card Docker Image

This service for Element43 provides a drop-in replacement for EMDR. It fetches market data from ESI and provides a ZMQ socket compatible with EMDR's output format based on UUDIF. On the first run updates are spread over five minutes. Subsequent requests are made when the region's cache in ESI expires (every five minutes). The region's data is augmented with data for publicly accessible (depending on the token you supply) structures (citadels). Citadels whose market endpoint returned a 403 (Forbidden), are put on a blacklist which gets wiped every twelve hours. While the markets are updated on cache expiration (~ every five minutes), available regions and citadels are updated every 30 minutes. Types on the market are updated every two hours. Each message on the ZeroMQ socket contains a whole region. Types with no orders yield an empty list of rows inside the result set (see UUDIF docs). De-duplication by downstream consumers can be achieved by hashing the individual rowset's rows and comparing hashes with past values. See emdr-to-nsq for an example.

Obtaining a refresh Token

Installation

Either use the prebuilt Docker images and pass the appropriate env vars (see below), or:

  • Clone this repo into your gopath
  • Run go get
  • Run go build

Deployment Info

Builds and releases are handled by Drone.

Environment Variable Default Description
LOG_LEVEL info Threshold for logging messages to be printed
CLIENT_ID none Required - your 3rd party app's client ID - get it from https://developers.eveonline.com
SECRET_KEY none Required - your 3rd party app's secret key - get it from https://developers.eveonline.com
REFRESH_TOKEN none Required - A valid refresh token - see above docs for generating one
ZMQ_BIND_ENDPOINT tcp://127.0.0.1:8050 The ZMQ enpoint will bind to this address you could use tcp://*:8050to listen on any address
LOCATION_SERVICE_URL https://element-43.com/api/static-data/v1/location/ URL of service providing location info - see static-data