Intent

List intent actions for account

Returns the append-only action history across intents on the requested trading account in ascending intent and sequence order. If no actions exist for the account, the response is 200 with an empty data array. Service-account callers must provide x-organization-id and have intent:read; API-key callers need organization intent read permission; user callers need an organization admin, member, or read-only role. Non-service callers can only read their principal organization, and the trading account must belong to the resolved organization.

GET

accounts

{account_id}

intents

List intent actions for account

curl --request GET \
  --url https://api.anthid.com/v1/accounts/{account_id}/intents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.anthid.com/v1/accounts/{account_id}/intents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/accounts/{account_id}/intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anthid.com/v1/accounts/{account_id}/intents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anthid.com/v1/accounts/{account_id}/intents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.anthid.com/v1/accounts/{account_id}/intents")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/accounts/{account_id}/intents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "intent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": "<string>",
      "seq": 123,
      "symbol": "<string>",
      "client_reference_id": "<string>",
      "limit_price": "<string>",
      "stop_price": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-organization-id

string<uuid> | null

Organization id required when reading with service-account credentials

Path Parameters

account_id

string<uuid>

required

Trading account id whose intent actions should be listed

Query Parameters

next_cursor

string

Sequence cursor returned by a previous response

limit

integer

Maximum number of actions to return. Values are clamped to the range 1 through 100.

Required range: x >= 0

Response

Intent actions retrieved

data

object[]

required

Show child attributes

next_cursor

string | null

Submit intentAppends a create, replace, or cancel trading intent for the requested trading account. Submission is authorized for API-key callers that belong to the account organization and have organization intent edit permission. Create intents on live accounts additionally require the Trading Live entitlement and must pass controls evaluation before an action and outbox record are written.

List intent actions for account

curl --request GET \
  --url https://api.anthid.com/v1/accounts/{account_id}/intents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.anthid.com/v1/accounts/{account_id}/intents"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/accounts/{account_id}/intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anthid.com/v1/accounts/{account_id}/intents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anthid.com/v1/accounts/{account_id}/intents"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.anthid.com/v1/accounts/{account_id}/intents")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/accounts/{account_id}/intents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "intent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": "<string>",
      "seq": 123,
      "symbol": "<string>",
      "client_reference_id": "<string>",
      "limit_price": "<string>",
      "stop_price": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}