market-streamer

Market Streamer

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

• Create an application on https://developers.eveonline.com - for scopes choose
  • esi-universe.read_structures.v1
  • esi-markets.structure_markets.v1
• You can use any SSO script for obtaining a token
• For fetching the token with evedata use something like http://localhost:3000/X/bootstrapEveSSOAnswer as callback URL
• Note the client ID and secret and configure evedata with it
• Use the route http://localhost:3000/X/bootstrapEveAuth for obtaining your token
• Configure the market streamer with your ID, secret and refresh token
• Set your callback URL to something like eveauth-e43://market-streamer - you won't need it anymore

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.