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.1.tar.gz (26.1 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: pricestf-1.1.1.tar.gz
  • Upload date:
  • Size: 26.1 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.1.tar.gz
Algorithm Hash digest
SHA256 380992df8941a2b74d6ab9281860ad4b70451a0022385b77fd21ab6b941aa7cd
MD5 aff66fcae9ca3b271887678474ee6ac4
BLAKE2b-256 1a30a2cc8e312f57e7120ac272e002dcfcf0fbb91b86c3b60305eeefed7ac836

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