Skip to main content

python api to Nicklason's prices.tf site.

Project description

PricesTF Python API

This modul is a simple python api for Nickalson's prices.tf website.

Installation

This module requires Python v3+ to run.

For install the module type this to your command line...

pip install pricestf

Quick Example

from pricestf import get_price

print(get_price("Scattergun", quality="Strange", australium=False, killstreak=0, error_message=True, ratelimit_data=False))

It will return a dictionary with the item's full name and with the buy- and sellprices.

{"name": "Strange Scattergun", "buy_price": {"keys": 0, "metal": 18.11}, "sell_price": {"keys": 0, "metal": 18.22}}

If something went wring, it returns an error code.

Getting item history

from pricestf import get_history

print(get_history("Scattergun", quality="Strange", australium=False, killstreak=0, error_message=True, ratelimit_data=False))

It will return a dictionary with the item's full name and the list of different prices on different dates.

{"name": "Strange Scattergun", "history": [{"time": 1602993074, "buy": {"keys": 0, "metal": 23.77}, "sell": {"keys": 0, "metal": 24.44}}, {"time": 1602998528, "buy": {"keys": 0, "metal": 23.77}, "sell": {"keys": 0, "metal": 30}}]}
Error codes:
  • 0: Unknown error
  • 1: Rate limit exceeded
  • 2: Item is not priced
  • 3: No prices for given source
  • 4: No item named
List of tf2 items

Qualities:
  • Normal
  • Genuine
  • Vintage
  • rarity3
  • Unusual
  • Unique (Default)
  • Community
  • Valve
  • Self-Made
  • Customized
  • Strange
  • Completed
  • Haunted
  • Collector's
  • Decorated Weapon
Australium:
  • It can be True if australium, and False if not. (Default: False)
Killstreak:
  • If not killstreak it's 0
  • If killstreak it's 1
  • If specialized it's 2
  • If pofessional it's 3
Error message:
  • If True it will print the error message, if False it wont. (Default: True)
Rate limit:

If True, besides the prices it will even return data about the current ratelimit status. (Default: False)

{"name": "Strange Scattergun", "buy_price": {"keys": 0, "metal": 18.11}, "sell_price": {"keys": 0, "metal": 18.22}, "ratelimit": {"limit": 180, "remaining": 178, "reset": 1583686816}}

Also usable:

from pricestf import ratelimit

print(ratelimit())

You will get a dictionary about the current ratelimit status.

{"limit": 180, "remaining": 178, "reset": 1583686816}

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pricestf-1.1.2.tar.gz (26.4 kB view details)

Uploaded Source

File details

Details for the file pricestf-1.1.2.tar.gz.

File metadata

  • Download URL: pricestf-1.1.2.tar.gz
  • Upload date:
  • Size: 26.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.54.0 CPython/3.7.3

File hashes

Hashes for pricestf-1.1.2.tar.gz
Algorithm Hash digest
SHA256 6ff056b2b994fbdc730927eab5b613cb0f067dc4dc53f23181554fd4b14da6fd
MD5 f738a32d1bc6563d4a32436f970e06df
BLAKE2b-256 70c4e1f0b101712c94d7195af5c12e224ff60a71cc11192c6737ffd113124465

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page