> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Geographic Intelligence

> Country-level attribution, timezone inference, and USDC/USDT geographic flow analysis for blockchain addresses

Allium's **Geographic Intelligence** schema provides country-level attribution and timezone inference for blockchain addresses, plus weekly USDC/USDT flow analysis by entity and country — enabling compliance monitoring, regional analysis, and cross-border flow insights. `master_list` classifies 80M+ addresses across 12 chains; \~20M of those (\~25%) receive a country attribution in `addresses_geography`.

<Note>
  Geographic attribution uses **flow-based wallet relatedness propagation** and multi-signal inference. A conviction level indicates attribution quality. Not every address can be attributed — see [Geo-Measurability](/historical-data/identity/geo/measurability).
</Note>

## Schema Location

All tables are in the `allium_identity.geo` schema in Snowflake, across three groups:

* **Core classification** — `master_list`, `addresses_geography`, `addresses_timezones`, `coverage_summary`
* **Exchange attribution** — `exchange_country_attribution` (local/regional exchanges), `exchange_gravity_weekly` (global exchanges)
* **Flow analysis (USDC/USDT)** — `entity_flows_weekly`, `country_corridors_weekly`, `country_corridors_distributed_weekly`

**Chain coverage.** `master_list` and `coverage_summary` carry per-chain rows for all 12 supported chains (ethereum, polygon, arbitrum, base, optimism, bsc, avalanche, linea, scroll, blast, tron, solana). `addresses_geography` and `addresses_timezones` collapse EVM chains into a single `evm` value, so their `chain` column is one of **`evm`**, **`solana`**, or **`tron`** (see the [join caveat](/historical-data/identity/geo/reference#chain-values--joining)).

## Data Flow Architecture

```mermaid theme={null}
graph TD
    FB[fungible_balances + Solana/Tron balances] --> WU[wallet_universe]
    AL[address_labels] --> ML[master_list]
    WU --> ML
    SEEDS[registry seeds: exchanges, countries] --> ML

    ML --> CS[coverage_summary]

    LBL[country-level labels] --> AG[addresses_geography]
    PROP[wallet-relatedness propagation] --> AG

    ATC[timezone distance models] --> AT[addresses_timezones]

    AL --> ECA[exchange_country_attribution]
    FLOWS[cex attributed flows] --> ECA
    WEB[SimilarWeb geo traffic] --> ECA
    SEEDS --> ECA

    ML --> EGW[exchange_gravity_weekly]
    CEXT[cex tagged transfers] --> EGW

    ET[stablecoin enriched_transfers] --> EF[entity_flows_weekly]
    ML --> EF
    ET --> CC[country_corridors_weekly]
    ML --> CC
    AG --> CC
    CC --> CCD[country_corridors_distributed_weekly]
    EGW --> CCD
```

## Tables

See the [Table Reference](/historical-data/identity/geo/tables) for full column-level schemas and example queries.

| Table                                                                                                                 | Purpose                                                            |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| [`master_list`](/historical-data/identity/geo/tables#1-master-list)                                                   | Geo-measurability + wallet-type classification for every address   |
| [`addresses_geography`](/historical-data/identity/geo/tables#2-addresses-geography)                                   | Country-level attribution with conviction levels                   |
| [`addresses_timezones`](/historical-data/identity/geo/tables#3-addresses-timezones)                                   | Timezone inference from transaction timing                         |
| [`coverage_summary`](/historical-data/identity/geo/tables#4-coverage-summary)                                         | Measurability statistics by chain and wallet type                  |
| [`exchange_country_attribution`](/historical-data/identity/geo/tables#5-exchange-country-attribution)                 | Operating-country attribution for local/regional exchanges         |
| [`exchange_gravity_weekly`](/historical-data/identity/geo/tables#6-exchange-gravity-weekly)                           | Weekly country distribution of flows for global exchanges          |
| [`entity_flows_weekly`](/historical-data/identity/geo/tables#7-entity-flows-weekly)                                   | Weekly USDC/USDT entity-to-entity flow matrix                      |
| [`country_corridors_weekly`](/historical-data/identity/geo/tables#8-country-corridors-weekly)                         | Weekly USDC/USDT country-to-country flows (exact attribution)      |
| [`country_corridors_distributed_weekly`](/historical-data/identity/geo/tables#9-country-corridors-distributed-weekly) | Country corridors with global-exchange legs distributed by gravity |

## Next Steps

<CardGroup cols={2}>
  <Card title="Geo-Measurability" icon="location-crosshairs" href="/historical-data/identity/geo/measurability">
    Why hosted and unhosted wallets differ, and what makes an address measurable
  </Card>

  <Card title="Table Reference" icon="table" href="/historical-data/identity/geo/tables">
    Full column-level schema for every table
  </Card>

  <Card title="Example Queries" icon="code" href="/historical-data/identity/geo/examples">
    Compliance, regional analysis, exchange gravity, and cross-border flow recipes
  </Card>

  <Card title="Field Values Reference" icon="list" href="/historical-data/identity/geo/reference">
    Data dictionary, data quality, and best practices
  </Card>
</CardGroup>