Web Services - Market Connect

Transcript

Web Services
2
1
Sommario
1
GENERALITÀ.................................................................................................................................... 3
1.1
1.2
2
SCOPO ……………………………………………………………………………………………………………………………………………………………………….3
DEFINIZIONI……………………………………………………………………………………………………………………………………………………………….3
REQUISITI FUNZIONALI .................................................................................................................. 3
2.1 AUTENTICAZIONE ………………………………………………………………………………………………………………………………………………………..3
2.1.1Profili……………………………………………………………………………………………………………………………………………………………………..3
2.2 SERVIZI DISPONIBILI……………………………………………………………………………………………………………………………………………………3
3
SERVIZIO “AUTENTICAZIONE”......................................................................................................... 4
3.1
4
WEB SERVICE – DISPLAY SERVICE…………………………………………………………………………………………………………………………………4
SERVIZIO “AZIONARIO ITALIA” – WEB SERVICES DISPONIBILI....................................................... 4
4.1 WEB SERVICE – SEARCH DISPLAY SERVICE ……………………………………………………………………………………………………………………..4
4.1.1
Popolamento combo “Titolo” nella form di ricerca…………………………………………………………………………………4
4.1.2
Ricerca effettiva……………………………………………………………………………………………………………………………………….5
4.2 WEB SERVICE – DISPLAY SERVICE………………………………………………………………………………………………………………………………..5
4.3 MERCATO DIURNO – UTILIZZO DEI WEB SERVICES………………………………………………………………………………………………………...5
4.3.1
Listino Principale (MTA)…………………………………………………………………………………………………………………………..5
4.3.2
Nuovo Mercato (MTAX)……………………………………………………………………………………………………………………………5
4.3.3
ETF………………………………………………………………………………………………………………………………….……………………….6
4.3.4
Diritti……………………………………………………………………………………………………………………………….……………………….6
4.3.5
Dettaglio Titolo Listino Principale, Nuovo Mercato, ETF, Diritti …………………………………….……………………..6
4.3.6
Prezzo corrente……………………………………………………………………………………………………………….……………………..7
4.4 MERCATO AFTER HOURS – UTILIZZO DEI WEB SERVICES……………………………………………………………………….………………………7
4.4.1
Listino Principale…………………………………………………………………………………………………………………………………….7
4.4.2
Nuovo Mercato ……………………………………………………………………………………………………………………………………….7
4.4.3
Dettaglio Titolo Listino Principale, Nuovo Mercato ……………………………………………………………………………….8
4.4.4
Prezzo corrente………………………………………………………………………………………………………………………………………8
5
SERVIZIO “COVERED WA RRANT” – “WARRANT” – WEB SERVICES DISPONIBILI……………………………9
5.1 WEB SERVICE – BASKETDISPLAY SERVICE…………………………………………………………………………………………………………………..10
5.2 WEB SERVICE – SEARCH DISPLAY SERVICE ………………………………………………………………………………………………………………….10
5.2.1
Popolamento form di ricerca………………………………………………………………………………………………………………..10
5.2.2
Ricerca effettiva…………………………………………………………………………………………………………………………………….11
5.3 WEB SERVICE – DISPLAY SERVICE……………………………………………………………………………………………………………………………..11
5.4 WARRANT – UTILIZZO DEI WEB SERVICES………………………………………………………………………………………………………………….12
5.4.1
Ricerca titoli Warrant……………………………………………………………………………………………………………………………12
5.4.2
Dettaglio Titolo Warrant mercato diurno……………………………………………………………………………………………..12
5.5 SERVIZIO “COVERED WARRANT DIURNO ” – UTILIZZO DEI WEB SERVICES………………………………………………………………………12
5.5.1
Ricerca titoli Covered Warrant mercato diurno…………………………………………………………………………………..12
5.5.2
Dettaglio Titolo Covered Warrant mercato diurno……………………………………………………………………………….13
5.6 SERVIZIO “COVERED WARRANT TAH”…………………………………………………………………………………………………………………………13
5.6.1
Ricerca titoli Covered Warrant TAH……………………………………………………………………………………………………..13
5.6.2
Dettaglio Titolo Covered Warrant mercato TAH……………………………………………………………………………………13
6
SERVIZIO “OBBLIGAZIONI” – WEB SERVICES DISPONIBILI ........................................................... 14
6.1 WEB SERVICE – SEARCH DISPLAY SERVICE ……………………………………………………………………………………………………………………14
6.1.1
Popolamento combo “Titolo” nella form di ricerca……………………………………………………………………………….14
6.1.2
Ricerca effettiva……………………………………………………………………………………………………………………………………..14
6.2 WEB SERVICE – DISPLAYSERVICE……………………………………………………………………………………………………………………………….14
6.3 BOT – UTILIZZO DEI WEB SERVICES………………………………………………………………………………………………………………………….14
6.4 TITOLI DI STATO – UTILIZZO DEI WEB SERVICES…………………………………………………………………………………………………………15
6.5 OBBLIGAZIONI – UTILIZZO DEI WEB SERVICES……………………………………………………………………………………………………………15
6.6 DETTAGLIO TITOLO BOT, TITOLI DI STATO , OBBLIGAZIONI – UTILIZZO DEI WEB SERVICES …………………………………………….16
6.7 PREZZO CORRENTE – UTILIZZO DEI WEB SERVICES………………………………………………………………………………………………………16
7
SERVIZIO “AZIONARIO ESTERO” – WEB SERVICES DISPONIBILI .................................................... 16
7.1
7.2
7.3
7.4
7.5
8
WEB SERVICE – SEARCH DISPLAY SERVICE ……………………………………………………………………………………………………………………16
WEB SERVICE – DISPLAY SERVICE……………………………………………………………………………………………………………………………….17
LISTINO – UTILIZZO DEI WEB SERVICES ……………………………………………………………………………………………………………………..17
DETTAGLIO TITOLO – UTILIZZO DEI WEB SERVICES………………………………………………………………………………………………………17
PREZZO CORRENTE – UTILIZZO DEI WEB SERVICES……………………………………………………………………………………………………….18
NOTE............................................................................................................................................. 18
3
Generalità
Scopo
Il presente documento ha l’obiettivo di illustrare la logica di funzionamento dei Web Services forniti da Borsa Italiana.
Definizioni
Termine
Web Service
SOAP
Token
Definizione
Sistema software implementato per consentire l’interoperabilità tra sistemi diversi tra loro,
posizionati su una stessa rete.
Protocollo per lo scambio di messaggi tra componenti software.
Stringa criptata e univoca necessaria per l’autenticazione di un utente.
Requisiti Funzionali
Autenticazione
Tutta la comunicazione avviene server side, ossia la piattaforma di Home Banking del Cliente effettua richieste dei dati
verso i Web Services di Borsa Italiana esposti.
L’applicazione del cliente provvede, come primo passaggio, ad effettuare chiamata al metodo di Autenticazione
inserendo username e password relativi al profilo dell’utente che effettua la richiesta.
In risposta a tale chiamata, il metodo restituisce un token utilizzato per tutte le richieste successive allo scopo di
autenticare l’applicazione del Cliente con il profilo dell’utente, mediante inclusione in un SOAP Header dei successivi
messaggi SOAP.
Se l’autenticazione non va a buon fine:
?
il server ritorna un codice http 500;
?
viene generato un SOAP Fault contenente la descrizione dell’errore.
Il token ha una durata di 10 minuti (valore attuale) scaduta la quale l’applicazione del cliente deve provvedere a
riautenticarsi per creare un altro token.
Profili
Ogni utente del servizio di Home Banking del Cliente ha un profilo di visualizzazione dei dati all’interno dell’Informativa
erogata tramite il Market Connect Web.
Il profilo creato all’interno dell’applicazione Market Connect Web permetterà la visualizzazione dei dati in modo
coerente con la profilazione associata al servizio di Informativa (Delay Time vs. Real Time).
Servizi disponibili
Riportiamo nella tabella di seguito la lista delle funzionalità standard richieste dal cliente.
ACCESSO DIRETTO: principali funzionalità
Ricerca prezzo corrente titolo
Ricerca per stringa descrittiva con opzione "Inizia con…"
su mercato "Az. Italia" e tipi "listino principale", "nuovo mercato", "ETF" o "diritti"
Ricerca per stringa descrittiva con opzione "Contiene…"
Ricerca per stringa descrittiva con opzione "Esatto"
Ricerca per stringa descrittiva con opzione "Inizia con…"
su mercato "After Hours" e tipi "listino principale" o "nuovo mercato"
Ricerca per stringa descrittiva con opzione "Contiene…"
4
Ricerca per stringa descrittiva con opzione "Esatto"
Ricerca su borsa estera selezionato dai listini disponibili (Amsterdam, Bruxelles, …).
Ricerca su listino New York NYSE per lettera iniziale
Ricerca covered warrant per emittente
Ricerca covered warrant per sottostante
Ricerca tutti i warrant
Ricerca BOT per vita residua da oggi a n mesi
Ricerca BOT per codice isin
Ricerca tutti i BOT
Ricerca Titoli di Stato per tipo (BTP,…)
Ricerca Titoli di Stato per anno di scadenza
Ricerca Titoli di Stato per codice isin
Ricerca tutti i Titoli di Stato
Ricerca tutte le obbligazioni
Dettaglio titolo di un mercato specifico
Nei paragrafi successivi illustreremo nel dettaglio il funzionamento dei Web Services.
Servizio “Autenticazione”
Web Service – DisplayService
Nome del Web Service: DisplayService
Metodo da invocare: autenticate(String username, String password)
Per chiamare questo servizio è necessario il passaggio di due parametri:
?
username
?
password
Il servizio restituisce al metodo che l’ha invocato un parametro, necessario per il riconoscimento dell’utente nelle
richieste successive:
?
token.
Servizio “Azionario Italia” – Web Services disponibili
La ricerca dei titoli del Mercato Azionario consente al momento di effettuare ricerca degli strumenti del mercato diurno
e del mercato serale.
All’interno delle 2 macro categorie di ricerca è obbligatorio selezionare il “mercato” di riferimento del titolo ossia:
?
Listino Principale (mercato MTA);
?
Nuovo Mercato (mercato MTAX);
?
ETF (non disponibile nella ricerca TAH);
?
Diritti (non disponibile nella ricerca TAH).
Sempre all’interno delle form è obbligatorio inserire la descrizione degli strumenti da ricercare secondo 3 diverse
modalità:
?
Inizia con…;
?
Contiene…;
?
Esatto.
Web Service – SearchDisplayService
Nome del Web Service: SearchDisplayService
Popolamento combo “Titolo” nella form di ricerca
Metodo da invocare: getListAzioniItalia (Boolean tah)
5
Questo metodo è utilizzato per il popolamento della combo “Titolo” nella pagina “Inserimento Ordine di
Compravendita” del mercato azionario italiano diurno e serale. Restituirà una lista contente le coppie descrizione titolo,
isin.
Descrizione dei parametri:
?
tah: è booleano e quindi può assumere i valori: true, false.
Ricerca effettiva
Metodo da invocare: getAzioniItalia(String grp, Boolean tah, String titolo, String tiporicerca)
Questo metodo è necessario per la ricerca di uno strumento.
?
?
?
?
grp: può assumere i valori: “mta”, “nm”, “etf”, “diritti”;
tah: è booleano e quindi può assumere i valori: true, false.
titolo: corrisponde al nome dello strumento e deve essere almeno di tre caratteri
tiporicerca: può assumere i valori: “iniziacon”, “esatto”, “contiene”.
Tutti i parametri sono obbligatori e devono essere valorizzati secondo le condizioni indicate, altrimenti la ricerca non
produrrà nessun risultato.
Invocare uno tra questi metodi:
?
getMTADisplay(String isin) metodo di default con tah=false;
?
getMTADisplay(String isin, boolean tah);
?
getMTADisplay(String isin, boolean tah, String[] params)
Per richiedere il prezzo corrente del titolo specificare i seguenti parametri:
?
String params[] = {“ultimoPrezzo”, “oraUltimoPrezzo”}.
Questo metodo è necessario per richiedere il dettaglio di un titolo e il prezzo corrente di un titolo.
Mercato diurno – Utilizzo dei Web Services
Listino Principale (MTA)
(ws: SearchDisplayService; metodo: getAzioniItalia)
Parametri da passare per la richiesta:
?
grp = “mta”;
?
tah=false; (boolean)
?
titolo (almeno tre caratteri);
?
tipologia = “iniziacon” / “contiene”/ “esatto”.
L’output della richiesta dovrà contenere almeno:
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Nuovo Mercato (MTAX)
6
?
grp = “nm”;
?
?
?
tipologia = “iniziacon” / “contiene” / “esatto”.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
ETF
?
grp = “etf”;
?
?
?
tipologia = “iniziacon” / “contiene” / “esatto”.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Diritti
?
grp=“diritti”;
?
?
?
tipologia=“iniziacon” / “contiene” / “esatto”.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Dettaglio Titolo Listino Principale, Nuovo Mercato, ETF, Diritti
(ws: DisplayService; metodo: getMTADisplay)
?
codice ISIN;
?
tah=false; (boolean).
?
Titolo
7
?
?
?
Dati Ultimo contratto:
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
Dati Giornalieri:
o
Pz. Apertura;
o
Pz. Minimo;
o
Quantità;
o
Pz. Ufficiale;
o
Q.tà apertura;
o
Pz. Massimo;
o
Num. Contratti;
o
Pz. Riferimento;
Dati Seduta Precedente:
o
Data Seduta;
o
Pz. Ufficiale;
o
Pz. Riferimento.
Prezzo corrente
?
codice ISIN;
?
tah (boolean: true = tah, false = diurno).
Mercato After Hours – Utilizzo dei Web Services
Listino Principale
?
grp = “mta”;
?
tah=true; (boolean)
?
?
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Nuovo Mercato
?
grp = “nm”;
?
tah=true; (boolean)
?
?
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
8
?
?
?
Min;
Max;
Vol.
Dettaglio Titolo Listino Principale, Nuovo Mercato
?
codice ISIN;
?
tah = true. (boolean)
?
Titolo
?
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
?
Dati Giornalieri:
o
Pz. Massimo;
o
Pz. Minimo;
o
Quantità Totale;
o
Controvalore;
o
Pz. Medio;
o
Pz Medio seduta precedente;
o
Var.% Pz Medio.
Prezzo corrente
?
codice ISIN;
?
tah (boolean: true = tah, false = diurno).
9
Servizio “Covered Warrant” – “Warrant” – Web Services disponibili
La ricerca dei titoli Warrant consente al momento di effettuare la ricerca degli strumenti Warrant e degli strumenti
Covered Warrant, questi ultimi relativi sia al mercato diurno che al mercato serale.
Per quanto riguarda, invece, gli strumenti Covered Warrant, la ricerca è suddivisa in due fasi consecutive.
La prima fase prevede la restituzione da parte del servizio, di tutti i parametri necessari alla costruzione di una form di
ricerca. Il metodo coinvolto è getSedexSearch, il quale, a fronte del passaggio della tipologia dello strumento e del
parametro che indica se il mercato è diurno o serale,
restituisce un insieme di parametri che il cliente può usare per la costruzione della suddetta form.
Di seguito forniamo un’immagine di esempio di una form di ricerca. Il cliente sarà comunque libero di gestire i dati
restituiti dal servizio e di visualizzare le combo nel modo che ritiene più adeguato.
La seconda fase comprende la ricerca effettiva degli strumenti. I metodi coinvolti sono getSedexBasket e
getSedexBasketTAH. Il primo metodo deve essere invocato nel caso in cui, nella prima fase sia stato passato il
parametro che indica “mercato diurno”. Il secondo metodo deve essere invocato nel caso in cui, nella prima fase sia
stato passato il parametro che indica “mercato serale”.
I parametri da passare e quelli restituiti sono dettagliati nei paragrafi successivi. Di seguito forniamo un piccolo
schema logico che illustra il funzionamento del servizio.
10
Web Service – BasketDisplayService
Nome del Web Service: BasketDisplayService
Metodi da invocare: getWarrant()
Il metodo è necessario per visualizzare la lista degli strumenti Warrant.
Parametri: nessuno
Popolamento form di ricerca
Metodo da invocare: getSedexSearch(String tipo, Boolean tah)
Questo metodo è utilizzato per popolare la form allo scopo di impostare la ricerca effettiva degli strumenti Covered
Warrant.
Parametri da passare per il popolamento della form di ricerca:
?
tipo = “plainvanilla” / “lev_cartificates” / ”inv_certificates” / “esotici”;
?
tah = true; / tah = false.
Parametri restituiti per il popolamento della form di ricerca relative al tipo scelto:
11
?
?
?
?
?
?
?
?
?
Lista “Tipologia”,
Lista “Emittente”
Lista sottostanti “Indici”,
Lista sottostanti “Azioni Italiane”,
Lista sottostanti “Azioni Estere”,
Lista sottostanti “Valute”,
Lista sottostanti “Altro”,
Lista sottostanti “Materie Prime”,
Lista sottostanti “Tassi di Interesse”.
Ricerca effettiva
Metodo da invocare: getSedexBasket(String grp, String alfacode, Date dataScad, String codTipoProd, String
codEmit)
Metodo da invocare: getSedexBasketTAH(String grp, String alfacode, Date dataScad, String codTipoProd,
String codEmit)
Questi metodi sono necessari per effettuare una ricerca tra gli strumenti Covered Warrant.
?
Il parametro codTipoProd corrisponde al valore scelto nella combo “Tipologia”
?
Il parametro codEmit corrisponde al valore scelto nella combo “Emittente”
?
Il parametro dataScad corrisponde al valore scelto nella combo “Data Scadenza”
?
Il parametro alfacode corrisponde al valore scelto nelle combo “Valore del Sottostante”, selezionato tra
“Indici”, “Azioni Italiane”, “Azioni Estere”, “Valute”, “Altro”, “Materie Prime”
?
Il parametro grp può assumere i seguenti valori, in base alle scelte effettuate all’interno delle combo:
Covered Warrant
Plain Vanilla
Leverage Certificates
Investment Certificates
Strutturati/Esotici
Sottostante
Indici
Azioni Italiane
Azioni Estere
Valute
Altro
Materie Prime
Tassi di Interesse
Indici
Azioni Italiane
Azioni Estere
Valute
Altro
Materie Prime
Tassi di Interesse
Indici
Azioni Italiane
Azioni Estere
Valute
Altro
Materie Prime
Tassi di Interesse
Indici
Azioni Italiane
Azioni Estere
Valute
Altro
Materie Prime
Tassi di Interesse
Grp
MTDVanillaIndici
MTDVanillaAzioniIt
MTDVanillaAzioniEst
MTDVanillaValuta
MTDVanillaAltro
MTDVanillaMateriePrime
MTDVanillaTassiInt
MTDLevCertificatesIndici
MTDLevCertificatesAzioniIt
MTDLevCertificatesAzioniEst
MTDLevCertificatesValuta
MTDLevCertificatesAltro
MTDLevCertificatesMateriePrime
MTDLevCertificatesTassiInt
MTDInvCertificatesIndici
MTDInvCertificatesAzioniIt
MTDInvCertificatesAzioniEst
MTDInvCertificatesValute
MTDInvCertificatesAltro
MTDInvCertificatesMateriePrime
MTDInvCertificatesTassiInt
MTDEsoticiIndici
MTDEsoticiAzioniIt
MTDEsoticiAzioniEst
MTDEsoticiValuta
MTDEsoticiAltro
MTDEsoticiMateriePrime
MTDEsoticiTassiInt
Tutti i parametri sono obbligatori a meno della dataScad, e devono essere valorizzati secondo le condizioni indicate,
altrimenti la ricerca non produrrà nessun risultato.
Nome Web Service: DisplayService
12
?
?
?
getSedexDisplay(String isin) default tah false;
getSedexDisplay (Str ing isin, boolean tah);
getSedexDisplay (String isin, boolean tah, String[] params)
Questo metodo è necessario per richiedere il dettaglio di un titolo.
Warrant – Utilizzo dei Web Services
Ricerca titoli Warrant
(ws: BasketDisplayService; metodo: getWarrant)
Nessun parametro da passare per la richiesta.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Dettaglio Titolo Warrant mercato diurno
Parametri da passare per la ricerca:
?
Codice ISIN;
?
tah = false; (boolean).
?
Titolo
?
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
?
Dati Giornalieri:
o
Pz. Apertura;
o
Pz. Minimo;
o
Quantità;
o
Pz. Ufficiale;
o
Q.tà apertura;
o
Pz. Massimo;
o
Num. Contratti;
o
Pz. Riferimento;
?
o
Data Seduta;
o
Pz. Ufficiale;
o
Pz. Riferimento.
Servizio “Covered Warrant Diurno” – Utilizzo dei Web Services
Ricerca titoli Covered Warrant mercato diurno
(ws: SearchDisplayService; metodo: getSedexBasket)
Si fa riferimento al sottoparagrafo 6.2.2 per la descrizione dei parametri.
13
?
?
?
?
?
?
?
?
Titolo;
Codice ISIN;
Ora;
Ultimo;
Diff. %;
Min;
Max;
Vol.
Dettaglio Titolo Covered Warrant mercato diurno
(ws: DisplayService; metodo: getSedexDisplay)
?
Codice ISIN;
?
tah = false (boolean).
?
Titolo
?
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
?
Dati Giornalieri:
o
Pz. Apertura;
o
Pz. Minimo;
o
Quantità;
o
Pz. Ufficiale;
o
Q.tà apertura;
o
Pz. Massimo;
o
Num. Contratti;
o
Pz. Riferimento;
?
o
Data Seduta;
o
Pz. Ufficiale;
o
Pz. Riferimento.
Servizio “Covered Warrant TAH”
Ricerca titoli Covered Warrant TAH
(ws: SearchDisplayService; metodo: getSedexBasketTAH)
Si fa riferimento al sottoparagrafo 6.2.2 per la descrizione dei parametri.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Dettaglio Titolo Covered Warrant mercato TAH
(ws: DisplayService; metodo: getSedexDisplay)
?
codice ISIN;
?
tah = true. (boolean)
14
?
Titolo
?
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
?
Dati Giornalieri:
o
Pz. Massimo;
o
Pz. Minimo;
o
Qtà. Totale;
o
Controvalore;
o
Prezzo Medio;
o
Prezzo Medio seduta prec.;
o
Variazione % Prezzo Medio.
Servizio “Obbligazioni” – Web Services disponibili
La ricerca dei titoli Obbligazionari consente di effettuare ricerca degli strumenti così suddivisi:
?
Obbligazioni;
?
BOT;
?
Titoli di Stato.
Popolamento combo “Titolo” nella form di ricerca
Metodo da invocare: getListTitoliStato()
Questo metodo è necessario per il popolamento della combo “Titolo” nella pagina “Inserimento Ordine di
Compravendita” del mercato MOT per gli strumenti della categoria “Titoli di Stato”. Restituirà una lista contente le
coppie descrizione titolo, isin.
Ricerca effettiva
Metodo da invocare: getMOT(String grp, Date scadenza, String isin, String emittente)
La valorizzazione dei parametri viene descritta nei paragrafi che seguono. Il parametro grp è obbligatorio.
Web service – DisplayService
Metodi da invocare:
?
getMOTDisplay(String isin);
?
getMOTDisplay(String isin, String[] params)
?
BOT – Utilizzo dei Web Services
(ws: SearchDisplayService; metodo: getMOT )
?
grp = “bot”;
?
scadenza = data – valorizzato esclusivamente per ricerca su “Vita residua”, altrimenti nullo;
15
?
?
codice isin – valorizzato esclusivamente per ricerca su “ISIN”, altrimenti nullo;
codice isin società emittente – non applicabile per BOT, quindi nullo;
?
Titolo
o
Descrizione;
o
Codice ISIN;
?
Asta
o
Prezzo;
o
Fase;
?
Sottoscrizione
o
Prezzo;
o
Ora;
?
Ul. Prez. Valido
o
Prezzo;
o
Data.
Titoli di Stato – Utilizzo dei Web Services
?
grp = “btp”; “cct”; “ctz ” - deve essere passato uno solo tra questi valori;
?
scadenza = data – valorizzato esclusivamente per ricerca su “Anno Scadenza” (31/12/<anno>), altrimenti
nullo;
?
codice isin – valorizzato esclusivamente per ricerca su “ISIN”, altrimenti nullo;
?
codice isin società emittente – non applicabile per Titolo di Stato, quindi nullo.
?
Titolo
o
Descrizione;
o
Codice ISIN;
?
Asta
o
Prezzo;
o
Fase;
?
Sottoscrizione
o
Prezzo;
o
Ora;
?
Ul. Prez. Valido
o
Prezzo;
o
Data.
Obbligazioni – Utilizzo dei Web Services
?
grp = “obbl”;
?
scadenza = data – non applicabile, quindi nullo;
?
codice isin – non applicabile, quindi nullo;
?
codice isin società emittente.
?
Titolo
o
Descrizione;
o
Codice ISIN;
?
Asta
o
Prezzo;
o
Fase;
?
Sottoscrizione
o
Prezzo;
o
Ora;
?
Ul. Prez. Valido
o
Prezzo;
o
Data.
16
Dettaglio Titolo BOT, Titoli di Stato, Obbligazioni – Utilizzo dei Web Services
(ws: DisplayService; metodo: getMOTDisplay)
?
Codice ISIN;
?
Titolo
?
Dati Giornalieri:
o
Pz. Asta,
o
Fase Asta,
o
Pz. Sottoscrizione,
o
Ora Sottoscrizione,
o
Ultimo Pz. Valido,
o
Data;
?
Dati Emissione:
o
Pz. Emissione;
o
Data Emissione;
o
Data Scadenza;
o
Vita Residua;
?
Dati Rendimento:
o
Rend. Immediato;
o
Rend. Effettivo;
o
Rateo; (non compare per BOT)
o
Cedola; (non compare per BOT)
o
I Stacco; (non compare per BOT)
o
II Stacco; (non compare per BOT)
Prezzo corrente – Utilizzo dei Web Services
(ws: DisplayService; metodo: getMOTDisplay)
Parametro da passare per la richiesta:
?
Codice ISIN;
Servizio “Azionario Estero” – Web Services Disponibili
All’interno di questa sezione è possibile effettuare, sulla base del mercato selezionato all’interno del menù a tendina
“Listino”, una ricerca per i titoli appartenenti ai panieri esteri di riferimento, ossia:
?
Aex;
?
Bel20;
?
Dax30;
?
FTSE100;
?
Ibex35;
?
Cac40;
?
Smi30;
?
S&P500.
Metodo da invocare: getAzioniEstero(String listino, String lettera).
Questo metodo è necessario per la ricerca di uno strumento.
?
listino: “AEX”; / “BEL20”; / “DAX100”; / “FTSE100”; / “IBEX35”; / “CAC40”; / “SMI”; / “NASDAQ”; / “NYSE”.
È un parametro obbligatorio
?
lettera: iniziale del titolo; costituisce un parametro obbligatorio per i titoli del paniere S&P500 quotati sul
mercato NYSE.
17
?
getDisplayEstero(String idInt);
?
getDisplayEstero(String idInt, String[] params)
?
Listino – Utilizzo dei Web Services
(ws: SearchDisplayService; metodo: getAzioniEstero)
Si fa riferimento al paragrafo 8.1 per la descrizione dei parametri.
?
Titolo;
?
Codice ISIN;
?
Ora;
?
Ultimo;
?
Diff. %;
?
Min;
?
Max;
?
Vol.
Dettaglio Titolo – Utilizzo dei Web Services
(ws: DisplayService; metodo: getDisplayEstero)
?
Codice IdInt;
?
Titolo
?
o
Ultimo Prezzo;
o
Quantità;
o
Ora;
o
Variazione %;
?
Dati Giornalieri:
o
Pz. Apertura;
o
Pz. Massimo;
o
Pz. Minimo;
o
Q.tà Totale;
o
Controvalore;
o
Num. Contratti;
o
Pz. Riferimento;
o
Pz. Riferimento seduta precedente.
18
Prezzo corrente – Utilizzo dei Web Services
(ws: DisplayService; metodo: getDisplayEstero)
Parametro da passare per la richiesta:
?
Codice Int.
Note
È opportuno che il cliente preveda delle politiche di caching dei dati restituiti dai Web Services, al fine di evitare un
eccessivo numero di chiamate, con il conseguente sovraccarico dei sistemi.

Web Services - Market Connect

Transcript

Documenti analoghi

avviso per gli azionisti di bank of america azione collettiva

RELAZIONE TRIMESTRALE La relazione trimestrale al 31 marzo

PITECO INCONTRA LA COMUNITA` FINANZIARIA TEDESCA ALL

LISTINO STUDENTCARD Vetture CITY CAR 48 € 95 € 136 € 180 € 20

avviso per gli azionisti di pfizer inc. azione collettiva

avviso per gli azionisti di skypeople fruit juice inc azione collettiva

comunicazione internal dealing del 01.08.2014

F.I.L.A. ( Fabbrica Italiana Lapis ed Affini ), è l`azienda che ha

ALLEGATO 6 /ANNEX 6 SCHEMA DI COMUNICAZIONE AI SENSI