We provide a range of services for data retrieving about the annotation information and effect prediction of each variant in dbSNP using the SOAP interface. The WSDL for each service is available in the API tab.


Each service returns JSON string including all related information with key/value.

Regional Annotation Service:
Service Function Name Description Parameters
Region Service getDiseaseSnpByIdService The disease related information which detected by current GWAS (name = "id4diseasesnp") String snpId (dbSNP id)
getOneKGenomeSNPByPos The 1000 genome SNP in a given position (name = "chrom4oneksnp") String chrom, (name = "pos4oneksnp") long pos
getRefGeneByRegionService The RefGene in a given region (name = "chrom") String chrom, (name = "start") long start (name = "end") long end
getOmimGeneByRegionService The OMIM Gene in a given region
getDGVByRegionService The Database of Genome Variants(DGV) variants in a given region
getKnownGeneByRegionService The Known Gene inofrmation in a given region
getEnsGeneByRegionService The Ensemble Gene information in a given region
getSmallRNAByRegionService The Small RNA in a given region
getMiRNATargetByRegionService The miRNA Target information in a given region
getTFBSByRegionService The TFBS information in a given region
getEvoFoldRegionService The conserved functional RNA information in a given region
getPhastConsElements46wayService The conserved elements(46way) information in a given region
getGADByRegionService The Gene Association Database(GAD) elements in a given region
getEnhancerByRegionService The human enhancers information in a given region
getCTCFByRegionService The CTCF insulator information in a given region
getLncRNAByRegtionService The human long non-coding RNA information in a given region
Variant Function Service:
Service Function Name Description Parameters
Function Service getTFBSSnpService All TF motifs predicted with significant variant affinity (name = "snpid") long snpId
getPitaMiRnaTargetSnpService All MiRNA Targets (PITA) predicted with significant variant affinity
getMirandaMiRnaTargetSnpService All MiRNA Targets (miRanda) predicted with significant variant affinity
getSpliceSiteSnpService All splicing skipping or extension predicted with significant variant affinity
getSnpPostiveSelectionService TAS variant positive selection score
getThreeWaySnpExpressionByIdService Gene co-expression affected by assigned variant
getHapMapEqtlService The HapMap eQTL mapping prediction by assigned variant
getNSFPService All non-synonymous TAS predicted with significant deterioration (name = "chrom4nsfp") String chrom, (name = "pos4nsfp") long pos

GWASrap Web Services is constructed under the Apache CXF. Available SOAP services can be visited from http://wanglab.hku.hk:8080/gwasdbws_gwasrap/ws. The corresponding WSDL definition can be used to generate the functions of each service. Following shows the steps of retrieving data by JAVA client.


  • Download Apache CXF binary release from http://cxf.apache.org/download.html.
  • Execute wsdl2java on one WSDL path (eg: http://wanglab.hku.hk:8080/gwasdbws_gwasrap/ws/functional?wsdl).
  • Create a JAVA Class to visit each function provided by Web Service.
  • Please check the demo code from here. Corresponding libraries of Apache CXF are needed.