DocsThe data protocol
value/v1
packages/core/schema/value.schema.jsonOn this page
What a map's token is worth in dollars, and how much of it there is (board #91; Elco, 11 Nov: 'monetary estimates of the value of these petals and the stakes and the supply and all of these data that we can put about each community and tokens'): its price from NEAR Intents' 1Click list, its supply from its own chain, and its reading's totals at that price. One per map, named by the map's address, read again to refresh. A token 1Click doesn't price has price null: no price, never a guess.
Fields
| Field | Type or allowed values | Presence in its parent | Description |
|---|---|---|---|
petal |
"value/v1" | Required | |
about |
string | Required | the map, by its address (its card's id) |
asset |
object | Required | what is priced: the asset its reading's holdings name (an EVM token's address in lower case, a Solana mint, NEAR), and its symbol |
asset.id |
string | Required | |
asset.symbol |
string / null | Required | |
price |
choice | Required | dollars for one whole token, as 1Click lists it, or else DefiLlama, or null: no price |
price (variant 1) |
object | Required | |
price (variant 1).usd |
number | Required | |
price (variant 1).source |
string | Required | where the price is from, in a word: 1click (NEAR Intents' list), or defillama (its open prices) for what 1Click doesn't list |
price (variant 1).ref |
string | Required | which asset it is there (1Click's asset id, DefiLlama's chain:address and its confidence), and why when it isn't the token itself (NEAR, priced as wNEAR) |
price (variant 1).at |
string | Required | when its source priced it |
price (variant 2) |
null | Required | |
supply |
choice | Required | how much of it there is, read from its own chain, in whole tokens, or null when the chain didn't say |
supply (variant 1) |
object | Required | |
supply (variant 1).amount |
string | Required | |
supply (variant 1).unit |
string | Required | |
supply (variant 1).source |
"chain" | Required | |
supply (variant 1).ref |
string | Required | the call it answered: totalSupply() on eip155:1:0x…, ft_total_supply on near:mainnet:…, getTokenSupply on solana:…, NEAR's total supply at a block |
supply (variant 1).at |
string | Required | |
supply (variant 2) |
null | Required | |
snapshot |
choice | Required | the reading its totals are of: the map's newest when it was read |
snapshot (variant 1) |
string | Required | |
snapshot (variant 2) |
null | Required | |
measure |
string / null | Required | the reading's own measure, the one its flower draws by default, or null |
totals |
array | Required | each amount measure of the reading held in this asset: its sum, and that at the price, or null with no price |
totals[] |
object | Required | |
totals[].measure |
string | Required | |
totals[].unit |
string | Required | |
totals[].amount |
string | Required | |
totals[].usd |
choice | Required | |
totals[].usd (variant 1) |
string | Required | |
totals[].usd (variant 2) |
null | Required | |
read_at |
string | Required |
Examples
value.v1.json
{
"petal": "value/v1",
"about": "eip155:1:0xc18360217d8f7ab5e7c516566761ea12ce7f9d72",
"asset": {
"id": "0xc18360217d8f7ab5e7c516566761ea12ce7f9d72",
"symbol": "ENS"
},
"price": {
"usd": 4.43965579,
"source": "defillama",
"ref": "ethereum:0xc18360217d8f7ab5e7c516566761ea12ce7f9d72, confidence 0.999 (https://coins.llama.fi/prices/current/ethereum:0xc18360217d8f7ab5e7c516566761ea12ce7f9d72)",
"at": "2026-11-11T14:14:00.000Z"
},
"supply": {
"amount": "100000000",
"unit": "ENS",
"source": "chain",
"ref": "totalSupply() and decimals() on eip155:1:0xc18360217d8f7ab5e7c516566761ea12ce7f9d72",
"at": "2026-11-11T14:14:57.316Z"
},
"snapshot": "ad9aedfde8f1f5e667b2577a8a31284ce5f5fe6e8c253e9d5eff8080a3559fd4",
"measure": "delegated_votes",
"totals": [
{
"measure": "delegated_votes",
"unit": "ENS",
"amount": "3986197.896935631",
"usd": "17697346.57"
}
],
"read_at": "2026-11-11T14:14:57.316Z"
}
Full schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "urn:petal:schema:value:v1",
"title": "Petal value v1",
"description": "What a map's token is worth in dollars, and how much of it there is (board #91; Elco, 11 Nov: 'monetary estimates of the value of these petals and the stakes and the supply and all of these data that we can put about each community and tokens'): its price from NEAR Intents' 1Click list, its supply from its own chain, and its reading's totals at that price. One per map, named by the map's address, read again to refresh. A token 1Click doesn't price has price null: no price, never a guess.",
"type": "object",
"additionalProperties": false,
"required": [
"petal",
"about",
"asset",
"price",
"supply",
"snapshot",
"measure",
"totals",
"read_at"
],
"properties": {
"petal": {
"const": "value/v1"
},
"about": {
"description": "the map, by its address (its card's id)",
"type": "string",
"minLength": 3
},
"asset": {
"description": "what is priced: the asset its reading's holdings name (an EVM token's address in lower case, a Solana mint, NEAR), and its symbol",
"type": "object",
"additionalProperties": false,
"required": [
"id",
"symbol"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"symbol": {
"type": [
"string",
"null"
]
}
}
},
"price": {
"description": "dollars for one whole token, as 1Click lists it, or else DefiLlama, or null: no price",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"usd",
"source",
"ref",
"at"
],
"properties": {
"usd": {
"type": "number",
"minimum": 0
},
"source": {
"description": "where the price is from, in a word: 1click (NEAR Intents' list), or defillama (its open prices) for what 1Click doesn't list",
"type": "string",
"pattern": "^[a-z0-9_-]+$"
},
"ref": {
"description": "which asset it is there (1Click's asset id, DefiLlama's chain:address and its confidence), and why when it isn't the token itself (NEAR, priced as wNEAR)",
"type": "string",
"minLength": 1
},
"at": {
"description": "when its source priced it",
"type": "string",
"format": "date-time"
}
}
},
{
"type": "null"
}
]
},
"supply": {
"description": "how much of it there is, read from its own chain, in whole tokens, or null when the chain didn't say",
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"amount",
"unit",
"source",
"ref",
"at"
],
"properties": {
"amount": {
"$ref": "#/$defs/decimal"
},
"unit": {
"type": "string"
},
"source": {
"const": "chain"
},
"ref": {
"description": "the call it answered: totalSupply() on eip155:1:0x…, ft_total_supply on near:mainnet:…, getTokenSupply on solana:…, NEAR's total supply at a block",
"type": "string",
"minLength": 1
},
"at": {
"type": "string",
"format": "date-time"
}
}
},
{
"type": "null"
}
]
},
"snapshot": {
"description": "the reading its totals are of: the map's newest when it was read",
"oneOf": [
{
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
{
"type": "null"
}
]
},
"measure": {
"description": "the reading's own measure, the one its flower draws by default, or null",
"type": [
"string",
"null"
]
},
"totals": {
"description": "each amount measure of the reading held in this asset: its sum, and that at the price, or null with no price",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"measure",
"unit",
"amount",
"usd"
],
"properties": {
"measure": {
"type": "string",
"minLength": 1
},
"unit": {
"type": "string"
},
"amount": {
"$ref": "#/$defs/decimal"
},
"usd": {
"oneOf": [
{
"$ref": "#/$defs/decimal"
},
{
"type": "null"
}
]
}
}
}
},
"read_at": {
"type": "string",
"format": "date-time"
}
},
"$defs": {
"decimal": {
"type": "string",
"pattern": "^[0-9]+(\\.[0-9]+)?(e[-+]?[0-9]+)?$"
}
}
}