https://api.vertalo.com/docs/ats-exchange/ Recent content in 4 ATS Actions on Vertalo API Primer Hugo -- gohugo.io en Copyright © {year} Vertalo Inc., a SeriesX Company. All rights reserved. Tue, 28 Jan 2020 00:34:39 +0900 https://api.vertalo.com/docs/ats-exchange/overview/ Tue, 28 Jan 2020 00:39:09 +0900 https://api.vertalo.com/docs/ats-exchange/overview/ ATS/Exchange integrations are standardized through an API derived from the Vertalo GraphQL schema. Because of the high compliance requirements/costs associated with post-issuance trading and transfer, the goal of the Vertalo API is designed to make it as easy as possible to convey data between systems in order to maximize consistency. While the Vertalo platform uses a transaction-based architecture under the hood, we do not currently expose this to the API user and translate trading and transfer calls to transactions as needed. https://api.vertalo.com/docs/ats-exchange/create-investor/ Tue, 28 Jan 2020 00:39:09 +0900 https://api.vertalo.com/docs/ats-exchange/create-investor/ Request: mutation { makeInvestor( input: { name: "John Jones" email: "john.jones@example.com" } ) { account { id } } } Response: { "data": { "makeInvestor": { "account": { "id": "9452007f-429c-478d-92f2-096b8e32b829" } } } } In this example, the mutation creates a new investor. This makes it possible for an ATS to pre-populate investors on the Vertalo platform prior to trading in order create efficiencies when trading eventually occurs. This is not a requirement, however, as new investors (those not already on the Vertalo platform) can be automatically created when trades are recorded. https://api.vertalo.com/docs/ats-exchange/batch-transfer/ Tue, 28 Jan 2020 00:39:09 +0900 https://api.vertalo.com/docs/ats-exchange/batch-transfer/ Request: mutation { batchTransfer ( input: { idempotencyId: "" transfer: [ { idempotencyId: "" investorId: "" securityId: "" usdPrice: "" transferPrice: { currency: "" amount: "" } holdings: [ { id: "" amount: "" } ] signature: { status: "" signature: "" date: "" } investorInformation: { name: "" taxId: "" email: "" address: [ { lineOne: "" lineTwo: "" lineThree: "" lineFour: "" city: "" province: "" postalCode: "" country: "" } ] parties: [ { firstName: "" lastName: "" taxId: "" email: "" address: [ { lineOne: "" lineTwo: "" lineThree: "" lineFour: "" city: "" province: "" postalCode: "" country: "" } ] } ] data: { field1: "" field2: "" } } to: { id: "" email: "" name: "" jurisdiction: "" accountSetupData: { type: "" formationDate: "" taxId: "" addresses: [ { lineOne: "" lineTwo: "" lineThree: "" lineFour: "" city: "" province: "" postalCode: "" country: "" type: "" } ] parties: [ { email: "" firstName: "" lastName: "" taxId: "" dateOfBirth: "" usCitizen: true isPrimary: true allowLogin: true addresses: [ { lineOne: "" lineTwo: "" lineThree: "" lineFour: "" city: "" province: "" postalCode: "" country: "" type: "" } ] } ] } } tags: [ { id: "" data: { field1: "" field2: "" } } ] data: { field1: "" field2: "" } matchedOn: "" settledOn: "" } ] } ) { id requestId type status createdOn executedOn requestByRequestId { data } } } Numeric field Usage transfer. https://api.vertalo.com/docs/ats-exchange/useful-queries/ Tue, 28 Jan 2020 00:39:09 +0900 https://api.vertalo.com/docs/ats-exchange/useful-queries/ Query Securities Request: query { allSecurities { nodes { id holdingsBySecurityId { nodes { id investorId amount createdOn accountByInvestorId { id name email } } } } } } Response: { "data": { "allSecurities": { "nodes": [ { "id": "6a93a168-31b6-4a67-b9f9-8cda51e5e6ba", "holdingsBySecurityId": { "nodes": [ { "id": "67ebd6a5-3ffa-4336-b683-31d1d4251a2c", "investorId": "d6fb328d-2426-4689-98d0-8a0a03679a03", "amount": "100000.000000000000000000", "createdOn": "2021-12-16T22:05:46.253555+00:00", "accountByInvestorId": { "id": "d6fb328d-2426-4689-98d0-8a0a03679a03", "name": "Bob Smith", "email": "bob.smith@example.com" } } ] } } ] } } } In this example, the query fetches all securities (and respective holdings) for which you are the listing ATS.