Coin
Active Development
This asset type is currently in active development and is subject to change. Fields, formats, and behavior may be updated without prior notice.
Collectible coins including US Mint releases, commemoratives, and numismatic coins.
External IDs
| Field | Required | Description | Example |
|---|---|---|---|
| NGC | No | NGC census ID | "525801" |
Asset Details
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| id | Yes | string | Internal Tradepost asset ID (UUID) | "68c1f500-6ea1-4e29-88cc-be320288a49c" |
| name | Yes | string | Full coin name | "1776-2026 W Eagle Liberty Bell S$1 PF" |
| year_released | No | integer | Year released | 2026 |
| composition | No | string | Material composition | "99.9% Silver" |
| weight_grams | No | number | Weight in grams | 31.103 |
| weight_ounces | No | number | Weight in ounces | 1.0 |
| purity | No | number | Purity (0.0 to 1.0) | 0.999 |
| mintage | No | integer | Total coins struck | 500000 |
| mint_name | No | string | Mint name | "West Point" |
| mint_mark | No | string | Mint mark | "W" |
| image_url | No | string | Primary coin image URL | "https://cdn.tradepost.co/media/assets/.../coin.webp" |
Config Details
Configuration-level details distinguish different varieties of the same coin (different designations, mint marks, varieties).
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| id | Yes | string | Internal Tradepost asset configuration ID (UUID) | "8df496bc-547b-44ab-9100-5f2500560b49" |
| name | Yes | string | Full configuration name | "1776-2026 W Eagle Liberty Bell S$1 PF Raw" |
| denomination | No | string | Denomination | "S$1" |
| designation | No | string | Striking method | "PF" |
| mint_mark | No | string | Mint mark | "W" |
| variety | No | string | Variety or variation | "Ultra Cameo" |
| strike | No | string | Strike or production method | "Standard" |
| year_released | No | integer | Year released | 2026 |
| image_url | No | string | Primary product image URL | "https://cdn.tradepost.co/media/assets/.../coin.webp" |
Common Designations:
MS: Mint State (business strike)PF: ProofSP: SpecimenCAM: CameoUCAM: Ultra Cameo
Item Details
| Field | Required | Type | Description | Example |
|---|---|---|---|---|
| key_id | No | string | Internal Tradepost key ID for grouping items (UUID, may be null) | "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d" |
| key_ids | No | string[] | Array of internal Tradepost key IDs for this item | ["a1b2c3d4...", "b2c3d4e5..."] |
| fair_values | No | array | Fair value pricing information | [] |
| grading_company | No | string | Grading company | "NGC", "PCGS", "ANACS", "ICG", "CACG", "ICCS" |
| grade | No | string | Coin grade | "MS70", "PF69", "AU55" |
| certification_number | No | string | Certification/serial number from grading company | "6924381-001" |
| quantity | Yes | integer | Number of coins | 1 |
Supported Grading Companies:
NGC: Numismatic Guaranty CompanyPCGS: Professional Coin Grading ServiceANACS: American Numismatic Association Certification ServiceICG: Independent Coin GradersCACG: Certified Acceptance Corporation GradingICCS: International Coin Certification Service
Example
{
"asset_type": "COIN",
"external_ids": {},
"asset_details": {
"id": "68c1f500-6ea1-4e29-88cc-be320288a49c",
"name": "1776-2026 W Eagle Liberty Bell S$1 PF",
"year_released": 1776,
"mint_mark": "Eagle",
"image_url": "https://cdn.tradepost.co/media/assets/68c1f500-.../coin.webp"
},
"config_details": {
"id": "8df496bc-547b-44ab-9100-5f2500560b49",
"name": "1776-2026 W Eagle Liberty Bell S$1 PF Raw",
"denomination": "S$1",
"designation": "PF",
"mint_mark": "W",
"variety": "Raw",
"year_released": 2026,
"image_url": "https://cdn.tradepost.co/media/assets/68c1f500-.../coin.webp"
},
"item_details": {
"key_id": "bcaaf25b-fe0b-4258-b40a-0dd0cb7ab60d",
"key_ids": ["bcaaf25b-fe0b-4258-b40a-0dd0cb7ab60d"],
"fair_values": [],
"quantity": 1
}
}