Copygram

API Reference Guide

Base URL

Authentication

Rest API Reference

Accounts

Rooms

Blank

Api Documentation

Production

Sandbox

<p class="slate-p slate-indent-0" style="0px">The Base URL is a crucial element for making API calls, enabling you to clearly specify the root URL(s) for API requests. When making API calls, you combine the base URL with the specific endpoint path to form the complete request URL.</p><p class="slate-p slate-indent-0" style="0px">It supports multiple environments, including staging and production. Additionally, the base URL synchronizes with the API explorer, allowing you to seamlessly switch between environments like Sandbox and Production while trying out API calls.</p><p class="slate-p " ></p>

The Base URL is a crucial element for making API calls, enabling you to clearly specify the root URL(s) for API requests. When making API calls, you combine the base URL with the specific endpoint path to form the complete request URL.

It supports multiple environments, including staging and production. Additionally, the base URL synchronizes with the API explorer, allowing you to seamlessly switch between environments like Sandbox and Production while trying out API calls.

<p class="slate-p slate-indent-0" style="0px">When it comes to interacting with APIs, authentication is a critical step to ensure secure communication between your application and the API service. API authentication is performed via HTTP Basic Auth, which involves including your API key in the HTTP request headers. This method verifies your identity and grants you access to the API&apos;s resources, ensuring that only authorized users can make requests.</p><p class="slate-p slate-indent-0" style="0px">Copygram Sample API uses <code class="slate-code">API keys</code> to authenticate requests. </p><p class="slate-p " ></p><h3 class="slate-h3 " >To retrieve your API key from appv2.copygram.app/developers, follow these steps:</h3><p class="slate-p " >First of all, you should get approval from Copygram team.</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Sign in</strong>: Navigate to appv2.copygram.app/developers and sign in with your credentials.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">User Settings</strong>: Once logged in, locate the user settings. </div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Tools &amp; Integrations Tab</strong>: Within the user settings, find the &quot;Tools &amp; Integrations&quot; tab. Click on it to access settings related to integrations and tools.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Locate API Key</strong>: In the Tools &amp; Integrations tab, you should find your API key listed. </div></li></ol><p class="slate-p " ></p><h2 class="slate-h2 " >Add headers to an HTTP request</h2><p class="slate-p slate-indent-0" style="0px">When issuing an HTTP request to Copygram, each request must contain an <code class="slate-code">x-api-key</code> header that specifies a valid API key and must be encoded as JSON with the <code class="slate-code">Content-Type: application/json</code> header.</p><p class="slate-p slate-indent-0" style="0px"></p><div class="code-block-wrapper"  style="width:100%" ><div class="code-block-header">CURL</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-shell keep-markup drop-tokens"><div class="slate-code_line">curl -s -X POST &quot;https://external-api.copygram.app&quot; \</div><div class="slate-code_line">   -H &quot;Content-Type: application/json&quot; \</div><div class="slate-code_line">   -H &quot;x-api-key: Api_Key&quot; \</div><div class="slate-code_line">   -d &apos;{</div><div class="slate-code_line">         &quot;name&quot;: &quot;&quot;,</div><div class="slate-code_line">         &quot;phone_number&quot;: &quot;&quot;</div><div class="slate-code_line">      }</div></code></pre></div><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=warning ><div class="callout-icon"><svg width="18" height="16" viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M0.916637 15.5009C0.791637 15.5009 0.683998 15.4732 0.59372 15.4176C0.503443 15.362 0.430526 15.2857 0.37497 15.1884C0.319415 15.0912 0.288165 14.9905 0.28122 14.8864C0.274276 14.7822 0.305526 14.6745 0.37497 14.5634L8.4583 0.605103C8.52775 0.493991 8.60761 0.41413 8.69789 0.365519C8.78816 0.316908 8.88886 0.292603 8.99997 0.292603C9.11108 0.292603 9.21178 0.316908 9.30205 0.365519C9.39233 0.41413 9.47219 0.493991 9.54164 0.605103L17.625 14.5634C17.6944 14.6745 17.7257 14.7822 17.7187 14.8864C17.7118 14.9905 17.6805 15.0912 17.625 15.1884C17.5694 15.2857 17.4965 15.362 17.4062 15.4176C17.3159 15.4732 17.2083 15.5009 17.0833 15.5009H0.916637ZM1.99997 14.2509H16L8.99997 2.1676L1.99997 14.2509ZM9.0833 13.0634C9.26386 13.0634 9.41316 13.0044 9.53122 12.8864C9.64928 12.7683 9.7083 12.619 9.7083 12.4384C9.7083 12.2579 9.64928 12.1086 9.53122 11.9905C9.41316 11.8725 9.26386 11.8134 9.0833 11.8134C8.90275 11.8134 8.75344 11.8725 8.63539 11.9905C8.51733 12.1086 8.4583 12.2579 8.4583 12.4384C8.4583 12.619 8.51733 12.7683 8.63539 12.8864C8.75344 13.0044 8.90275 13.0634 9.0833 13.0634ZM9.0833 10.7509C9.26386 10.7509 9.41316 10.6919 9.53122 10.5739C9.64928 10.4558 9.7083 10.3065 9.7083 10.1259V6.70927C9.7083 6.52871 9.64928 6.37941 9.53122 6.26135C9.41316 6.1433 9.26386 6.08427 9.0833 6.08427C8.90275 6.08427 8.75344 6.1433 8.63539 6.26135C8.51733 6.37941 8.4583 6.52871 8.4583 6.70927V10.1259C8.4583 10.3065 8.51733 10.4558 8.63539 10.5739C8.75344 10.6919 8.90275 10.7509 9.0833 10.7509Z" fill="#F1C21B"></path></svg></div><div ><p class="slate-p " >Your API keys grant significant access, so it’s crucial to keep them safe! Avoid sharing your secret API keys in public places like GitHub, client-side code, and similar locations.</p></div></div><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=error ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M9.08366 9.9801C9.25033 9.9801 9.39269 9.92107 9.51074 9.80302C9.6288 9.68496 9.68783 9.53566 9.68783 9.3551V5.31344C9.68783 5.14677 9.62533 5.00441 9.50033 4.88635C9.37533 4.7683 9.22949 4.70927 9.06283 4.70927C8.88227 4.70927 8.73296 4.7683 8.61491 4.88635C8.49685 5.00441 8.43783 5.15371 8.43783 5.33427V9.37594C8.43783 9.5426 8.50033 9.68496 8.62533 9.80302C8.75033 9.92107 8.9031 9.9801 9.08366 9.9801ZM9.00033 13.1676C9.19477 13.1676 9.35796 13.1016 9.48991 12.9697C9.62185 12.8377 9.68783 12.6745 9.68783 12.4801C9.68783 12.2857 9.62185 12.1225 9.48991 11.9905C9.35796 11.8586 9.19477 11.7926 9.00033 11.7926C8.80588 11.7926 8.64269 11.8586 8.51074 11.9905C8.3788 12.1225 8.31283 12.2857 8.31283 12.4801C8.31283 12.6745 8.3788 12.8377 8.51074 12.9697C8.64269 13.1016 8.80588 13.1676 9.00033 13.1676ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C10.9448 16.0843 12.6114 15.3898 14.0003 14.0009C15.3892 12.612 16.0837 10.9454 16.0837 9.00094C16.0837 7.05649 15.3892 5.38982 14.0003 4.00094C12.6114 2.61205 10.9448 1.9176 9.00033 1.9176C7.05588 1.9176 5.38921 2.61205 4.00033 4.00094C2.61144 5.38982 1.91699 7.05649 1.91699 9.00094C1.91699 10.9454 2.61144 12.6989 4.00033 14.0009C5.38921 15.3898 7.05588 16.0843 9.00033 16.0843Z" fill="#E90005"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px">API requests without authentication will fail.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p>

When it comes to interacting with APIs, authentication is a critical step to ensure secure communication between your application and the API service. API authentication is performed via HTTP Basic Auth, which involves including your API key in the HTTP request headers. This method verifies your identity and grants you access to the API's resources, ensuring that only authorized users can make requests.

To retrieve your API key from appv2.copygram.app/developers, follow these steps:

First of all, you should get approval from Copygram team.

When issuing an HTTP request to Copygram, each request must contain an 

 header that specifies a valid API key and must be encoded as JSON with the 

<div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=success ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M7.77116 10.8968L5.72949 8.8551C5.60449 8.7301 5.45171 8.6676 5.27116 8.6676C5.0906 8.6676 4.93088 8.73705 4.79199 8.87594C4.6531 9.01482 4.58366 9.17455 4.58366 9.3551C4.58366 9.53566 4.6531 9.68844 4.79199 9.81344L7.33366 12.3551C7.45866 12.4801 7.60449 12.5426 7.77116 12.5426C7.93783 12.5426 8.08366 12.4801 8.20866 12.3551L13.2087 7.3551C13.3337 7.2301 13.3927 7.07732 13.3857 6.89677C13.3788 6.71621 13.3128 6.56344 13.1878 6.43844C13.0628 6.29955 12.9066 6.2301 12.7191 6.2301C12.5316 6.2301 12.3684 6.29955 12.2295 6.43844L7.77116 10.8968ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C11.0142 16.0843 12.6982 15.4072 14.0524 14.053C15.4066 12.6989 16.0837 11.0148 16.0837 9.00094C16.0837 6.98705 15.4066 5.30302 14.0524 3.94885C12.6982 2.59469 11.0142 1.9176 9.00033 1.9176C6.98644 1.9176 5.30241 2.59469 3.94824 3.94885C2.59408 5.30302 1.91699 6.98705 1.91699 9.00094C1.91699 11.0148 2.59408 12.6989 3.94824 14.053C5.30241 15.4072 6.98644 16.0843 9.00033 16.0843Z" fill="#06837A"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">Note:</strong> All of the stated endpoints and sections are for demonstration purposes only.</p></div></div><p class="slate-p " ></p>

<p class="slate-p " >List all user accounts</p><p class="slate-p " ></p>

List Accounts

x-api-key

Content-Type

accounts

<p class="slate-p " >Delete user account. Please be aware that once removed, the credits cannot be replaced. You can edit account details instead.</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

Delete user account. Please be aware that once removed, the credits cannot be replaced. You can edit account details instead.

Delete Account

account_name

message

<p class="slate-p " ><span style="color:rgb(0, 0, 0)">To Add Metatrader Account, you should check if server name exists in Copygram DB (Contact support elsewhere). 
</span></p><p class="slate-p " ><span style="color:rgb(0, 0, 0)">You can get the list of all servers (Metatrader4 or Metatrader5) instantly available by Copygram using GET Metatrader Servers Call. Our team will add any server per your request.
</span></p><p class="slate-p " ></p>

To Add Metatrader Account, you should check if server name exists in Copygram DB (Contact support elsewhere). 


You can get the list of all servers (Metatrader4 or Metatrader5) instantly available by Copygram using GET Metatrader Servers Call. Our team will add any server per your request.


Metatrader

<p class="slate-p " ></p><p class="slate-p " >To Add Tradelocker Account, it should be completed using 2 step:</p><p class="slate-p " >Step1: GET all accounts related to the user, the first API Call (Get) returns a “request_id” and account numbers “accounts” </p><p class="slate-p " >Step2: POST Call including with body that includes “request_id&quot; and “account_number” from the list returned by first API.</p><p class="slate-p " ></p>

To Add Tradelocker Account, it should be completed using 2 step:

Step1: GET all accounts related to the user, the first API Call (Get) returns a “request_id” and account numbers “accounts” 

Step2: POST Call including with body that includes “request_id" and “account_number” from the list returned by first API.

Tradelocker

<p class="slate-p " ></p><p class="slate-p " >To Add MatchTrader Account, it should be completed using 2 step:</p><p class="slate-p " >Step1: GET all accounts related to the user, the first API Call (Get) returns a “request_id” and account numbers “accounts” </p><p class="slate-p " >Step2: POST Call including with body that includes “request_id&quot; and “account_number” from the list returned by first API.</p><p class="slate-p " ></p>

To Add MatchTrader Account, it should be completed using 2 step:

Matchtrader

<p class="slate-p " ><span style="background-color:rgb(255, 255, 255);color:rgba(20, 23, 25, 0.84)">Get MatchTrader Account numbers from Tradelocker and request_id to confirm .</span></p><p class="slate-p " ></p>

Get MatchTrader Account numbers from Tradelocker and request_id to confirm .

Get MatchTrader Accounts

username

password

broker_url

request_id

<p class="slate-p " >Connect an account from account list returned from Step1.</p><p class="slate-p " ></p><p class="slate-p " ></p>

Connect an account from account list returned from Step1.

Connect MatchTrader Account

account_number

<p class="slate-p slate-indent-0" style="0px">Coming soon…</p><p class="slate-p slate-indent-0" style="0px"></p><p class="slate-p slate-indent-0" style="0px"></p><p class="slate-p " ></p>

DxTrade

<p class="slate-p slate-indent-0" style="0px">Coming soon ….</p>

Binance

<p class="slate-p slate-indent-0" style="0px">Coming Soon …</p><p class="slate-p " ></p>

Oanda

<div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=info ><div class="callout-icon"><svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M10.0628 14.1676C10.2434 14.1676 10.3927 14.1086 10.5107 13.9905C10.6288 13.8725 10.6878 13.7232 10.6878 13.5426V9.77177C10.6878 9.6051 10.6253 9.46274 10.5003 9.34469C10.3753 9.22663 10.2295 9.1676 10.0628 9.1676C9.88227 9.1676 9.73296 9.22663 9.61491 9.34469C9.49685 9.46274 9.43783 9.61205 9.43783 9.7926V13.5634C9.43783 13.7301 9.50033 13.8725 9.62533 13.9905C9.75033 14.1086 9.89616 14.1676 10.0628 14.1676ZM10.0003 7.62594C10.1948 7.62594 10.358 7.56344 10.4899 7.43844C10.6219 7.31344 10.6878 7.15371 10.6878 6.95927C10.6878 6.76482 10.6219 6.59816 10.4899 6.45927C10.358 6.32038 10.1948 6.25094 10.0003 6.25094C9.80588 6.25094 9.64269 6.32038 9.51074 6.45927C9.3788 6.59816 9.31283 6.76482 9.31283 6.95927C9.31283 7.15371 9.3788 7.31344 9.51074 7.43844C9.64269 7.56344 9.80588 7.62594 10.0003 7.62594ZM10.0003 18.3343C8.81977 18.3343 7.72255 18.1225 6.70866 17.6989C5.69477 17.2752 4.81283 16.6884 4.06283 15.9384C3.31283 15.1884 2.72602 14.3065 2.30241 13.2926C1.8788 12.2787 1.66699 11.1815 1.66699 10.0009C1.66699 8.83427 1.8788 7.74399 2.30241 6.7301C2.72602 5.71621 3.31283 4.83427 4.06283 4.08427C4.81283 3.33427 5.69477 2.74399 6.70866 2.31344C7.72255 1.88288 8.81977 1.6676 10.0003 1.6676C11.167 1.6676 12.2573 1.88288 13.2712 2.31344C14.285 2.74399 15.167 3.33427 15.917 4.08427C16.667 4.83427 17.2573 5.71621 17.6878 6.7301C18.1184 7.74399 18.3337 8.83427 18.3337 10.0009C18.3337 11.1815 18.1184 12.2787 17.6878 13.2926C17.2573 14.3065 16.667 15.1884 15.917 15.9384C15.167 16.6884 14.285 17.2752 13.2712 17.6989C12.2573 18.1225 11.167 18.3343 10.0003 18.3343ZM10.0003 17.0843C11.9448 17.0843 13.6114 16.3898 15.0003 15.0009C16.3892 13.612 17.0837 11.9454 17.0837 10.0009C17.0837 8.05649 16.3892 6.38982 15.0003 5.00094C13.6114 3.61205 11.9448 2.9176 10.0003 2.9176C8.05588 2.9176 6.38921 3.61205 5.00033 5.00094C3.61144 6.38982 2.91699 8.05649 2.91699 10.0009C2.91699 11.9454 3.61144 13.612 5.00033 15.0009C6.38921 16.3898 8.05588 17.0843 10.0003 17.0843Z" fill="#3960B4"></path></svg></div><div ><p class="slate-p slate-indent-0" style="0px"><strong class="slate-bold">Note:</strong> All of the stated endpoints and sections are for demonstration purposes only. Theneo does not manage payments API, get sales data, itemize payments, push orders to POS, and more.</p></div></div><p class="slate-p " ></p><p class="slate-p " ></p>

Sections