catsHTM XMatch

Cats Service provides cone search and cross-match on different catalogs. This service is based on catsHTM.

Arguments and units in requests

The parameters and units in the catsHTM API are the following:

Parameter

unit

catalog

string

ra

degrees

dec

degrees

radius (optional)

arcsec

Cross-match

Get the closest object, given RA and Dec, for a catalog or all of them.

GET catshtm.alerce.online/crossmatch[_all]

Cross-match on a catalog

Since the radius argument is optional, there are two ways to perform cross-match on a catalog.

  1. Providing a value for the radius:

curl "catshtm.alerce.online/crossmatch?catalog=SDSSDR10&ra=357.73373&dec=14.20514&radius=10"

  1. Not providing one:

curl "catshtm.alerce.online/crossmatch?catalog=SDSSDR10&ra=357.73373&dec=14.20514"

If a radius is provided, then that value is used. If not, the default value for that catalog is used. See default values in Available catalogs

Cross-match on all catalogs

For cross-matching on all catalogs, the same rule of providing a radius or not applies. Therefore, there are two ways to send the request.

  1. With radius:

curl "catshtm.alerce.online/crossmatch_all?ra=357.73373&dec=14.20514&radius=100"

  1. Without radius:

curl "catshtm.alerce.online/crossmatch_all?ra=357.73373&dec=14.20514"

Available catalogs:

For catalogs that have a value listed, this value is the radius used for cone search and cross-match. Otherwise, the default radius of 50 arcsec is used.

  • AAVSO_VSX

  • AKARI

  • APASS (2 arcsec)

  • CRTS_per_var

  • Cosmos

  • DECaLS (0.1 arcsec)

  • FIRST

  • GAIADR1 (0.1 arcsec)

  • GAIADR2 (0.1 arcsec)

  • GALEX

  • HSCv2

  • IPHAS

  • IRACgc

  • NEDz

  • NVSS (10.8 arcsec)

  • PTFpc

  • ROSATfsc

  • SAGE

  • SDSSDR10

  • SDSSoffset (0.1 arcsec)

  • SWIREz

  • SkyMapper (0.4 arcsec)

  • SpecSDSS

  • TMASS (2MASS)

  • TMASSxsc (2MASSxsc)

  • UCAC4

  • UKIDSS

  • VISTAviking

  • VSTatlas

  • VSTkids

  • WISE

  • XMM (8 arcsec)

  • unWISE