Get Assets Batch
curl --request POST \
--url https://api.allium.so/api/v1/developer/assets/batch \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
[
{
"id": 123,
"slug": "<string>",
"chain": "<string>",
"address": "<string>"
}
]
'import requests
url = "https://api.allium.so/api/v1/developer/assets/batch"
payload = [
{
"id": 123,
"slug": "<string>",
"chain": "<string>",
"address": "<string>"
}
]
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify([{id: 123, slug: '<string>', chain: '<string>', address: '<string>'}])
};
fetch('https://api.allium.so/api/v1/developer/assets/batch', 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.allium.so/api/v1/developer/assets/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'id' => 123,
'slug' => '<string>',
'chain' => '<string>',
'address' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.allium.so/api/v1/developer/assets/batch"
payload := strings.NewReader("[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.allium.so/api/v1/developer/assets/batch")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.allium.so/api/v1/developer/assets/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body[
{
"id": 123,
"slug": "<string>",
"source": "<string>",
"chain_specific_data": {},
"name": "<string>",
"symbol": "<string>",
"image_url": "<string>",
"circulating_supply": 123,
"token_creation_time": "2023-11-07T05:31:56Z"
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Assets
Get assets
Get assets by ID, slug, or (chain, address).
POST
/
api
/
v1
/
developer
/
assets
/
batch
Get Assets Batch
curl --request POST \
--url https://api.allium.so/api/v1/developer/assets/batch \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
[
{
"id": 123,
"slug": "<string>",
"chain": "<string>",
"address": "<string>"
}
]
'import requests
url = "https://api.allium.so/api/v1/developer/assets/batch"
payload = [
{
"id": 123,
"slug": "<string>",
"chain": "<string>",
"address": "<string>"
}
]
headers = {
"X-API-KEY": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify([{id: 123, slug: '<string>', chain: '<string>', address: '<string>'}])
};
fetch('https://api.allium.so/api/v1/developer/assets/batch', 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.allium.so/api/v1/developer/assets/batch",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'id' => 123,
'slug' => '<string>',
'chain' => '<string>',
'address' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.allium.so/api/v1/developer/assets/batch"
payload := strings.NewReader("[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-KEY", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.allium.so/api/v1/developer/assets/batch")
.header("X-API-KEY", "<api-key>")
.header("Content-Type", "application/json")
.body("[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.allium.so/api/v1/developer/assets/batch")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"id\": 123,\n \"slug\": \"<string>\",\n \"chain\": \"<string>\",\n \"address\": \"<string>\"\n }\n]"
response = http.request(request)
puts response.read_body[
{
"id": 123,
"slug": "<string>",
"source": "<string>",
"chain_specific_data": {},
"name": "<string>",
"symbol": "<string>",
"image_url": "<string>",
"circulating_supply": 123,
"token_creation_time": "2023-11-07T05:31:56Z"
}
]{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}This endpoint returns assets by ID, slug, or (chain, address).
This is a beta endpoint currently under active development. We’re working to stabilize the API and will minimize breaking changes wherever possible, but they may still occur as we refine the interface.For production support or migration assistance, reach out at hello@allium.so.
Supported Chains
Authorizations
Body
application/json
Response
(AssetResponse · object | null)[]
Successful Response
Unique asset identifier
URL-friendly asset identifier
Data source (e.g. allium)
Per-chain contract addresses and decimals
Show child attributes
Show child attributes
Token name
Token symbol
Token logo URL
Circulating token supply
Token creation timestamp (UTC)
Was this page helpful?
⌘I