swagger: '2.0'
info:
  x-logo:
    url: https://coinpaprika.com/static/files/d6d3c6e3.svg#greywizard/rock-coin-web/assets/coin/img/cp-logo-beta.svg
    backgroundColor: '#FFFFFF'
  description: "Coinpaprika API delivers free & frequently updated market data from the world of crypto: coin prices, volumes, market caps, ATHs, return rates and more.\n# Clients\n* [PHP](https://github.com/coinpaprika/coinpaprika-api-php-client)\n* [NodeJS](https://github.com/coinpaprika/coinpaprika-api-nodejs-client)\n* [GO](https://github.com/coinpaprika/coinpaprika-api-go-client)\n* [Swift](https://github.com/coinpaprika/coinpaprika-api-swift-client)\n* Community Contributed Clients:\n  * [C#](https://github.com/MSiccDev/CoinpaprikaAPI)\n# General\n* The base endpoint is: https://api.coinpaprika.com/v1/\n* All endpoints return either a JSON object or array\n* All timestamp related fields are in seconds\n# Errors\n* API errors are formatted as JSON:\n```{\"error\": \"<error message>\"}```\n* HTTP 4XX return codes are used for invalid requests - the issue is on the sender's side\n* HTTP 429 return code is used when breaking a request rate limit\n* HTTP 5XX return codes are used for internal errors - the issue is on coinpaprika's side\n# Rate limit\n* Single IP address can send less than 10 requests per second\n"
  version: 1.2.1
  title: Coinpaprika coins ticker API
host: api.coinpaprika.com
basePath: /v1
schemes:
- https
tags:
- name: ticker
paths:
  /ticker:
    get:
      tags:
      - ticker
      summary: Get ticker information for all coins
      produces:
      - application/json
      responses:
        200:
          description: successful operation
          schema:
            type: array
            items:
              $ref: '#/definitions/Tick'
        429:
          description: too many requests
  /ticker/{coin_id}:
    get:
      tags:
      - ticker
      summary: Get ticker information for specific coin
      produces:
      - application/json
      parameters:
      - name: coin_id
        in: path
        required: true
        description: ID of coin to return e.g. btc-bitcoin, eth-ethereum
        type: string
      responses:
        200:
          description: successful operation
          schema:
            $ref: '#/definitions/Tick'
        429:
          description: too many requests
        404:
          description: coin not found
definitions:
  Tick:
    type: object
    description: Tick response. Missing values are returned as empty string
    properties:
      id:
        type: string
        example: btc-bitcoin
      name:
        type: string
        example: Bitcoin
      symbol:
        type: string
        example: BTC
      rank:
        type: string
        example: '1'
      price_usd:
        type: string
        example: '9259.01'
      price_btc:
        type: string
        example: '1'
      volume_24h_usd:
        type: string
        example: '8102619999'
      market_cap_usd:
        type: string
        example: '157468557128'
      circulating_supply:
        type: string
        example: '17007062'
      total_supply:
        type: string
        example: '17007062'
      max_supply:
        type: string
        example: '21000000'
      percent_change_1h:
        type: string
        example: '-0.26'
      percent_change_24h:
        type: string
        example: '0.22'
      percent_change_7d:
        type: string
        example: '4.1'
      last_updated:
        type: string
        example: '1525088839'