Unique Identifier API

getUniqueIdentifier

The getUniqueIdentifier provides the Financial Instrument Global Identifier (FIGI) information for all available instruments.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

identifierType^optional

The code/value for the global identifier protocol.

Type

list-enum (A comma or semi-colon delimited string that must match a list of valid possible values.)

Example

openFIGI

Valid Values

openFIGI

barchartSymbols^optional

The unique barchart identifier. Multiple symbols can be requested separated by a comma.

Type

list (A comma or semi-colon delimited string.)

Example

IBM,GOOGL

exchange^optional

A valid exchange identifer code.

Type

string (A sequence of characters. (example: GOOG))

Example

NYSE

openFIGIGlobal^optional

The unique global OpenFIGI id. Multiple IDs can be requested separated by a comma.

Type

list (A comma or semi-colon delimited string.)

Example

BBG0015VZ6S1

openFIGIComposite^optional

The unique composite OpenFIGI id. Multiple IDs can be requested separated by a comma.

Type

list (A comma or semi-colon delimited string.)

Outputs

symbol
always returned

A symbol or code that identifies a financial instrument.

string
A sequence of characters. (example: GOOG)

symbolName
always returned

The name of the financial instrument.

string
A sequence of characters. (example: GOOG)

exchange
always returned

Exchange code for the marketplace where the financial instruments are listed.

string
A sequence of characters. (example: GOOG)

openFIGI
always returned

An object with OpenFIGI unique identifer information (global and composite) for each available symbol.

enum
A type which includes a list of valid possible values.

Status Code Responses

200

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://ondemand.websol.barchart.com/getUniqueIdentifier.json?apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getUniqueIdentifier.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "GOOGL",
            "symbolName": "Alphabet Cl A",
            "exchange": "NASDAQ",
            "openFIGI": {
                "global": "BBG009S4MT03",
                "composite": "BBG009S39JX6",
                "name": "ALPHABET INC-CL A",
                "securityType": "Common Stock",
                "securityType2": "Common Stock",
                "marketSector": "Equity",
                "securityDescription": "GOOGL",
                "currency": "USD"
            }
        },
        {
            "symbol": "IBM",
            "symbolName": "Intl Business Machines",
            "exchange": "NYSE",
            "openFIGI": {
                "global": "BBG000BLNQ16",
                "composite": "BBG000BLNNH6",
                "name": "INTL BUSINESS MACHINES CORP",
                "securityType": "Common Stock",
                "securityType2": "Common Stock",
                "marketSector": "Equity",
                "securityDescription": "IBM",
                "currency": "USD"
            }
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getUniqueIdentifier.xml?apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getUniqueIdentifier.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1

Response

<?xml version="1.0" encoding="utf-8"?>
<getUniqueIdentifier>
  <status>
    <code>200</code>
    <message>Success.</message>
  </status>
  <item>
    <symbol>GOOGL</symbol>
    <symbolName>Alphabet Cl A</symbolName>
    <exchange>NASDAQ</exchange>
    <openFIGI>
      <global>BBG009S4MT03</global>
      <composite>BBG009S39JX6</composite>
      <name>ALPHABET INC-CL A</name>
      <securityType>Common Stock</securityType>
      <securityType2>Common Stock</securityType2>
      <marketSector>Equity</marketSector>
      <securityDescription>GOOGL</securityDescription>
      <currency>USD</currency>
    </openFIGI>
  </item>
  <item>
    <symbol>IBM</symbol>
    <symbolName>Intl Business Machines</symbolName>
    <exchange>NYSE</exchange>
    <openFIGI>
      <global>BBG000BLNQ16</global>
      <composite>BBG000BLNNH6</composite>
      <name>INTL BUSINESS MACHINES CORP</name>
      <securityType>Common Stock</securityType>
      <securityType2>Common Stock</securityType2>
      <marketSector>Equity</marketSector>
      <securityDescription>IBM</securityDescription>
      <currency>USD</currency>
    </openFIGI>
  </item>
</getUniqueIdentifier>

CSV

GET

GET https://ondemand.websol.barchart.com/getUniqueIdentifier.csv?apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getUniqueIdentifier.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&identifierType=openFIGI&barchartSymbols=IBM%2CGOOGL&exchange=NYSE&openFIGIGlobal=BBG0015VZ6S1

Response

symbol,symbolName,exchange,global,composite,name,securityType,securityType2,marketSector,securityDescription,currency
"IBM","Intl Business Machines","NYSE","BBG000BLNQ16","BBG000BLNNH6","INTL BUSINESS MACHINES CORP","Common Stock","Common Stock","Equity","IBM","USD"
"GOOGL","Alphabet Cl A","NASDAQ","BBG009S4MT03","BBG009S39JX6","ALPHABET INC-CL A","Common Stock","Common Stock","Equity","GOOGL","USD"

PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
    'identifierType' => 'openFIGI',
    'barchartSymbols' => 'IBM,GOOGL',
    'exchange' => 'NYSE',
    'openFIGIGlobal' => 'BBG0015VZ6S1',
];

$result = $ondemand->getUniqueIdentifier($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")

Set result = ondemand.getUniqueIdentifier("YOUR_API_KEY", "openFIGI", "IBM,GOOGL", "NYSE", "BBG0015VZ6S1")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getUniqueIdentifier('YOUR_API_KEY', 'openFIGI', 'IBM,GOOGL', 'NYSE', 'BBG0015VZ6S1');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = ondemand.service.getUniqueIdentifier('YOUR_API_KEY', 'openFIGI', 'IBM,GOOGL', 'NYSE', 'BBG0015VZ6S1')

print(result)

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getUniqueIdentifier,
    message: {
        apikey: 'YOUR_API_KEY',
        identifierType: 'openFIGI',
        barchartSymbols: 'IBM,GOOGL',
        exchange: 'NYSE',
        openFIGIGlobal: 'BBG0015VZ6S1',
    }
)

response.body