Available Commands

Crypto Currency Prices

Returns the latest prices for 1000+ crypto currencies.

Example Request

$ curl cli.fyi/BTC

Example Response

{
    "type": "Bitcoin (BTC) Prices",
    "data": {
        "USD ($)": 7299.97,
        "EUR (€)": 6338.15,
        "GBP (£)": 5636.17,
        "AUD ($)": 9642.69,
        "CAD ($)": 9415.97,
        "BRL (R$)": 24559.16,
        "CHF (CHF)": 7528.65,
        "CLP ($)": 4675371.21,
        "CNY (¥)": 51398.69,
        "DKK (kr)": 51231.61,
        "HKD ($)": 57194.57,
        "INR (₹)": 490045.94,
        "ISK (kr)": 843540.55,
        "JPY (¥)": 833628.57,
        "KRW (₩)": 8250226.92,
        "NZD ($)": 12189.99,
        "PLN (zł)": 26717.84,
        "RUB (RUB)": 416001.11,
        "SEK (kr)": 60000.02,
        "SGD ($)": 10016.97,
        "THB (฿)": 230183.34,
        "TWD (NT$)": 219596.24
    }
}

BTC can be replaced with almost any crypto currency symbol. Data is provided by CryptoCompare.com.

Email Address Information

Returns information about an email address.

Example Request

$ curl cli.fyi/john.doe@10minutemail.com

Example Response

{
    "type": "Email Query",
    "data": {
        "validMxRecords": true,
        "freeProvider": false,
        "disposableEmail": true,
        "businessOrRoleEmail": false,
        "validHost": true
    }
}

IP Address Information

Returns geo-location and ASN/Organisation information related to an IP address.

Example Request

$ curl cli.fyi/8.8.8.8

Example Response

{
    "type": "IP Address",
    "data": {
        "organisation": "Google Inc.",
        "country": "United States",
        "countryCode": "US",
        "city": "Mountain View, California",
        "continent": "North America",
        "latitude": "37.751",
        "longitude": "-97.822"
    }
}

Media/URL Information

Returns detailed information about virtually any URL. Supports extracting data from oEmbed, TwitterCards, OpenGraph, LinkPulse, Sailthru Meta-data, HTML and Dublin Core.

Example Request

$ curl cli.fyi/https://vimeo.com/231191863

Example Response

{
    "type": "Vimeo Url",
    "data": {
        "title": "Low Earth Orbit",
        "description": "Orbital drone movements are theorbits...",
        "url": "https://vimeo.com/231191863",
        "type": "video",
        "tags": "Drone",
        "image": "https://i.vimeocdn.com/video/651947838_640.jpg",
        "imageWidth": 640,
        "imageHeight": 360,
        "code": "[embed code...]",
        "width": 640,
        "height": 360,
        "authorName": "Visual Suspect",
        "authorUrl": "https://vimeo.com/vsuspect",
        "providerName": "Vimeo",
        "providerUrl": "https://vimeo.com/",
        .......
}

Client Information

Returns information about the person/machine making the request.

Example Request

$ curl cli.fyi/me

Example Response

{
    "type": "Client Query",
    "data": {
        "userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.75 Safari/537.36",
        "iPAddress": "109.255.10.10",
        "browser": "Chrome Dev 62.0.3202.75",
        "operatingSystem": "Linux",
        "iPAddressInformation": {
            "organisation": "Liberty Global Operations B.V.",
            "country": "Ireland",
            "countryCode": "IE",
            "city": "Dublin",
            "continent": "Europe",
            "latitude": "53.3472",
            "longitude": "-6.2439"
        }
    }
}

Domain Whois / DNS information

Returns whois and DNS information for a given domain.

Example Request

$ curl cli.fyi/github.com

Example Response

{
    "type": "Domain Name",
    "data": {
        "dns": [
            "github.com.  3600 IN MX 5 ALT2.ASPMX.L.GOOGLE.com.",
            "github.com.  3600 IN MX 5 ALT1.ASPMX.L.GOOGLE.com.",
            "github.com.  40 IN A 192.30.253.113",
            "github.com.  40 IN A 192.30.253.112",
            "github.com.  651 IN NS ns-520.awsdns-01.net.",
            "github.com.  651 IN NS ns-421.awsdns-52.com.",
            "github.com.  651 IN NS ns-1283.awsdns-32.org.",
            "github.com.  900 IN SOA ns-1707.awsdns-21.co.uk. awsdns-hostmaster.amazon.com. (",
            "    1          ; serial",
            "    7200       ; refresh (2 hours)",
            "    900        ; retry (15 minutes)",
            "    1209600    ; expire (2 weeks)",
            "    86400      ; minimum (1 day)",
            "    )",
            "github.com.  2350 IN TXT \"docusign=087098e3-3d46-47b7-9b4e-8a23028154cd\"",
            "github.com.  2350 IN TXT \"v=spf1 ip4:192.30.252.0/22 ip4:208.74.204.0/22 ip4:46.19.168.0/23 include:_spf.google.com include:esp.github.com include:_spf.createsend.com include:mail.zendesk.com include:servers.mcsv.net ~all\""
        ],
        "whois": [
            "Domain Name: GITHUB.COM",
            "Registry Domain ID: 1264983250_DOMAIN_COM-VRSN",
            "Registrar WHOIS Server: whois.markmonitor.com",
            "Registrar URL: http://www.markmonitor.com",
          	....
        ]
    }
}

Date/Time Information

Returns information about the current UTC date and time.

Example Request

$ curl cli.fyi/time

Example Response

{
    "type": "Date/Time Information (UTC)",
    "data": {
        "day": "03",
        "month": "11",
        "year": "2017",
        "hour": "16",
        "minutes": "11",
        "seconds": "22",
        "dayName": "Friday",
        "MonthName": "November",
        "amOrPm": "pm",
        "unixEpoch": 1509728122,
        "formattedDate": "Fri, 03 Nov 2017 16:55:22 +0000"
    }
}

Programming Language Links

Returns useful and up-to-date links for programming languages.

PHP, Javascript & Java currently supported.

Example Request

$ curl cli.fyi/PHP

Example Response

{
    "type": "PHP Query",
    "data": {
        "documentation": "http://php.net/docs.php",
        "links": {
            "Awesome PHP": "https://github.com/ziadoz/awesome-php",
            "PHP The Right Way": "http://www.phptherightway.com",
            "Docker Repository": "https://hub.docker.com/_/php/",
            "PHP Fig": "http://www.php-fig.org/",
            "PHP Security": "http://phpsecurity.readthedocs.io/en/latest/index.html"
        }
    }
}

Country Information

Returns useful information about a given country.

Example Request

$ curl cli.fyi/united-states

Example Response

{
    "type": "Country Query",
    "data": {
        "commonName": "United States",
        "officialName": "United States of America",
        "topLevelDomain": ".us",
        "currency": "USD",
        "callingCode": "+1",
        "capitalCity": "Washington D.C.",
        "region": "Americas",
        "subRegion": "Northern America",
        "latitude": 38,
        "longitude": -97,
        "demonym": "American",
        "isLandlocked": "No",
        "areaKm": 9372610,
        "officialLanguages": "English"
    }
}

Help

Returns all possible query types and example queries.

Example Request

$ curl cli.fyi/help

Example Response

{
    "type": "Help",
    "data": {
        "IP Address Query": {
            "example": "https://cli.fyi/8.8.8.8"
        },
        "Media/Url Query": {
            "example": "https://cli.fyi/https://google.com"
        },
        "Email Address Query": {
            "example": "https://cli.fyi/test@10minutemail.com"
        },
        "Client (you) Query": {
            "example": "https://cli.fyi/me"
        },
        ...
    }
}

General Information

FAQ

Why?

cli.fyi's goal is to create a quick an easy way to fetch information about IPs, emails, domains etc. directly from the command line.

Colourised Output?

Unfortunately Curl currently doesn't support colourised output1. HTTPie is a good alternative which does support colour output.

The JSON-Formatter Chrome extension is a good solution for in-browser JSON formatting.

Rate Limits?

There are no rate limits, however we will block any IP which is abusing the service. If you need to make a significant number of requests you can always host your own version.

Who?

cli.fyi is developed by Dave Earley

1 To the best of my knowledge, please correct me if I'm wrong.

Credits

Data

Cli.fyi relies on the following services & projects for its data:

Hosting

Cli.fyi is hosted by Linode .

Terms of Service

Cli.fyi is provided as-is. Cli.fyi makes no guarantees about the quality of the service or the accuracy of data provided by the service.