{"info":{"name":"AfriFlux API","description":"Every API published through the AfriFlux catalog. Interactive documentation lives at https://www.afriflux.xyz/api-docs.\n\nSet apiKey to your key. A test key (af_test_...) is free and returns sample data.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json"},"auth":{"type":"bearer","bearer":[{"key":"token","value":"{{apiKey}}","type":"string"}]},"variable":[{"key":"baseUrl","value":"https://api.afriflux.xyz"},{"key":"apiKey","value":"af_test_your_key_here"}],"item":[{"name":"Wallet Labels API","description":"Find out which African venue an address belongs to, and what the venue uses it for. You pay only when we know the answer.","item":[{"name":"Look up one wallet label","request":{"method":"GET","description":"Returns who an address belongs to and what it is used for. Unmatched addresses are free; matches are charged by tier. Your balance must cover an operational match before the lookup runs.","header":[],"url":{"raw":"{{baseUrl}}/v1/labels/:chain/:address","host":["{{baseUrl}}"],"path":["v1","labels",":chain",":address"],"variable":[{"key":"chain","value":"base"},{"key":"address","value":"0x0000000000000000000000000000000000000001"}]}}},{"name":"Look up a batch of wallet labels","request":{"method":"POST","description":"Deduplicates identical chain/address pairs, then charges only for matches. meta.billed shows how many standard and operational matches you paid for.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/labels/batch","host":["{{baseUrl}}"],"path":["v1","labels","batch"]},"body":{"mode":"raw","raw":"{\n  \"wallets\": [\n    {\n      \"chain\": \"base\",\n      \"address\": \"0x0000000000000000000000000000000000000001\"\n    },\n    {\n      \"chain\": \"bsc\",\n      \"address\": \"0x0000000000000000000000000000000000000003\"\n    },\n    {\n      \"chain\": \"base\",\n      \"address\": \"0x00000000000000000000000000000000000000ff\"\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"See what we cover","request":{"method":"GET","description":"Lists every entity we label, its chains and the public roles we can return for it. Free. Use it to judge coverage before you spend credits.","header":[],"url":{"raw":"{{baseUrl}}/v1/labels/coverage","host":["{{baseUrl}}"],"path":["v1","labels","coverage"]}}},{"name":"View account usage","request":{"method":"GET","description":"Returns recent billable usage and month-to-date credit consumption. Paginate with limit and cursor; pass format=csv to download.","header":[],"url":{"raw":"{{baseUrl}}/v1/usage","host":["{{baseUrl}}"],"path":["v1","usage"]}}},{"name":"View credit balance and expiry","request":{"method":"GET","description":"Returns the unexpired balance and credit-lot expiry schedule.","header":[],"url":{"raw":"{{baseUrl}}/v1/credits","host":["{{baseUrl}}"],"path":["v1","credits"]}}},{"name":"Check API availability","request":{"method":"GET","description":"Confirms that the published API product and serving database are available.","header":[],"url":{"raw":"{{baseUrl}}/v1/health","host":["{{baseUrl}}"],"path":["v1","health"]}}}]},{"name":"Market Data API","description":"Token and universe time series, snapshots, and DEX-implied reference-rate prints for African stablecoins, served from AfriFlux's daily snapshot pipeline.","item":[{"name":"Query a token or universe time series","request":{"method":"GET","description":"Returns aligned period/value points from the daily snapshot pipeline. Use symbol=universe with a bare universe metric (transfer, dex, mints, burns, users) for cross-token series; otherwise metric uses the form dimension:measure where dimension is chain, dex_project, venue, mint_flow, or burn_flow. Ranges are capped per grain (daily 400, weekly 300, monthly 160, quarterly 80 most-recent points) and responses flag truncated separately from partial_last so incomplete final periods are never mistaken for complete ones.","header":[],"url":{"raw":"{{baseUrl}}/v1/market-data/timeseries/:symbol/:metric?grain=daily&entity=base","host":["{{baseUrl}}"],"path":["v1","market-data","timeseries",":symbol",":metric"],"query":[{"key":"grain","value":"daily"},{"key":"entity","value":"base"},{"key":"from","value":"","disabled":true},{"key":"to","value":"","disabled":true}],"variable":[{"key":"symbol","value":"cngn"},{"key":"metric","value":"chain:transfer_usd"}]}}},{"name":"Latest snapshot for one token","request":{"method":"GET","description":"Curated latest cut for a single token: supply, lifetime flows, holders, transfer and DEX totals, TVL, and corridor count, with as_of provenance. Accepts the manifest slug or symbol (cngn, cNGN_mento, cngn-mento).","header":[],"url":{"raw":"{{baseUrl}}/v1/market-data/tokens/:symbol/snapshot","host":["{{baseUrl}}"],"path":["v1","market-data","tokens",":symbol","snapshot"],"variable":[{"key":"symbol","value":"cngn"}]}}},{"name":"Latest universe snapshot","request":{"method":"GET","description":"Headline KPIs, the token leaderboard, and per-chain totals for the whole tracked stablecoin universe in one call.","header":[],"url":{"raw":"{{baseUrl}}/v1/market-data/universe/snapshot","host":["{{baseUrl}}"],"path":["v1","market-data","universe","snapshot"]}}},{"name":"DEX-implied USD reference rate (preview)","request":{"method":"GET","description":"Daily volume-weighted implied USD price per token across chains, floored by minimum per-chain daily volume to suppress thin-pool noise. Preview methodology: history depth follows the published DEX window and prints may restate once the canonical reference-rate pipeline ships.","header":[],"url":{"raw":"{{baseUrl}}/v1/market-data/rates/:symbol/usd?min_day_volume_usd=25000","host":["{{baseUrl}}"],"path":["v1","market-data","rates",":symbol","usd"],"query":[{"key":"from","value":"","disabled":true},{"key":"to","value":"","disabled":true},{"key":"min_day_volume_usd","value":"25000"}],"variable":[{"key":"symbol","value":"cngn"}]}}},{"name":"Check API availability","request":{"method":"GET","description":"Confirms that the published API product is available and identifies the serving environment.","header":[],"url":{"raw":"{{baseUrl}}/v1/market-data/health","host":["{{baseUrl}}"],"path":["v1","market-data","health"]}}}]},{"name":"Wallet Screening API","description":"One call for a compliance check. It tells you which African venue an address belongs to and what the venue uses it for, and whether a stablecoin issuer has frozen it or it is one step from frozen money, at the venues AfriFlux tracks. You pay only for the parts we have an answer for. Needs a paid account.","item":[{"name":"Screen one address","request":{"method":"GET","description":"Returns the wallet label and the freeze record for one address. Each part has its own matched flag, and you pay only for the parts that matched. A label you already paid for stays free until its valid_until.","header":[],"url":{"raw":"{{baseUrl}}/v1/screen/:chain/:address","host":["{{baseUrl}}"],"path":["v1","screen",":chain",":address"],"variable":[{"key":"chain","value":"ethereum"},{"key":"address","value":"0x00000000000000000000000000000000000f0001"}]}}},{"name":"Screen a batch of addresses","request":{"method":"POST","description":"Screens many addresses at once. Duplicates count once, and you pay only for the parts that matched. Your plan sets the largest batch.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/screen/batch","host":["{{baseUrl}}"],"path":["v1","screen","batch"]},"body":{"mode":"raw","raw":"{\n  \"wallets\": [\n    {\n      \"chain\": \"bsc\",\n      \"address\": \"0x0000000000000000000000000000000000000003\"\n    },\n    {\n      \"chain\": \"ethereum\",\n      \"address\": \"0x00000000000000000000000000000000000f0001\"\n    }\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"Check API availability","request":{"method":"GET","description":"Confirms the API is available and which environment answered.","header":[],"url":{"raw":"{{baseUrl}}/v1/screen/health","host":["{{baseUrl}}"],"path":["v1","screen","health"]}}}]},{"name":"Reference Data API","description":"The AfriFlux master tables: tokens, venues, corridors, chains, countries, and the section coverage matrix, all keyed by stable slugs and stamped with snapshot provenance. Unmetered by design; every other AfriFlux API joins onto these identifiers.","item":[{"name":"Reference catalog status","request":{"method":"GET","description":"Entity counts, coverage-matrix symbols, and the as_of provenance stamp for the current snapshot.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/status","host":["{{baseUrl}}"],"path":["v1","reference","status"]}}},{"name":"List tracked tokens","request":{"method":"GET","description":"The token master: slug (canonical join key), symbol, issuer, country, currency, status, launch date, and chains. Filterable by status, chain, or country.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/tokens","host":["{{baseUrl}}"],"path":["v1","reference","tokens"]}}},{"name":"Resolve one token plus its coverage matrix","request":{"method":"GET","description":"A single token master row joined with its per-section coverage states, so clients can learn which datasets exist for the token before querying other products. Accepts slug or symbol in any hyphen/underscore form.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/tokens/:symbol","host":["{{baseUrl}}"],"path":["v1","reference","tokens",":symbol"],"variable":[{"key":"symbol","value":"cngn"}]}}},{"name":"List supported chains","request":{"method":"GET","description":"Chain slugs and display names usable as entity filters across all products.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/chains","host":["{{baseUrl}}"],"path":["v1","reference","chains"]}}},{"name":"List tracked venues","request":{"method":"GET","description":"The venue master: roles, chain and token presence, first/last active day, and lifetime USD flow. Filterable by chain or role.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/venues","host":["{{baseUrl}}"],"path":["v1","reference","venues"]}}},{"name":"List tracked corridors","request":{"method":"GET","description":"The corridor master: base/quote token pairs per chain and project with lifetime trade counts. The enumeration for corridor analytics.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/corridors","host":["{{baseUrl}}"],"path":["v1","reference","corridors"]}}},{"name":"List covered countries","request":{"method":"GET","description":"Country slugs, names, and the tokens mapped to each currency area.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/countries","host":["{{baseUrl}}"],"path":["v1","reference","countries"]}}},{"name":"Dataset coverage matrix","request":{"method":"GET","description":"Per-token, per-section dataset availability (live, in_progress, no_coverage_yet, not_applicable). Query this before consuming any metric to avoid silent gaps.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/coverage","host":["{{baseUrl}}"],"path":["v1","reference","coverage"]}}},{"name":"Check API availability","request":{"method":"GET","description":"Confirms that the published API product is available and identifies the serving environment.","header":[],"url":{"raw":"{{baseUrl}}/v1/reference/health","host":["{{baseUrl}}"],"path":["v1","reference","health"]}}}]},{"name":"Freeze Check API","description":"Find out whether an address has been frozen by a stablecoin issuer, or is one step from frozen money, at the African venues AfriFlux tracks. You pay only when we have a record. No record means we hold nothing on the address, not that it is clear everywhere.","item":[{"name":"Check one address","request":{"method":"GET","description":"Says whether the address is on an issuer's freeze list, how many venues we track it dealt with, and whether a venue paid it after the freeze. Venues are counted, never named. Free when we hold no record. Needs a paid account.","header":[],"url":{"raw":"{{baseUrl}}/v1/freeze/addresses/:address","host":["{{baseUrl}}"],"path":["v1","freeze","addresses",":address"],"variable":[{"key":"address","value":"0x00000000000000000000000000000000000f0001"}]}}},{"name":"Check a batch of addresses","request":{"method":"POST","description":"Checks many addresses at once. Duplicates count once, and you pay only for addresses we hold a record on. Your plan sets the largest batch.","header":[{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{baseUrl}}/v1/freeze/batch","host":["{{baseUrl}}"],"path":["v1","freeze","batch"]},"body":{"mode":"raw","raw":"{\n  \"addresses\": [\n    \"0x00000000000000000000000000000000000f0001\",\n    \"0x00000000000000000000000000000000000f0002\",\n    \"0x00000000000000000000000000000000000000ff\"\n  ]\n}","options":{"raw":{"language":"json"}}}}},{"name":"See what we cover","request":{"method":"GET","description":"How many venues we track, on which chains, and how many frozen addresses have dealt with them. Free.","header":[],"url":{"raw":"{{baseUrl}}/v1/freeze/coverage","host":["{{baseUrl}}"],"path":["v1","freeze","coverage"]}}},{"name":"Check API availability","request":{"method":"GET","description":"Confirms the API is available and which environment answered.","header":[],"url":{"raw":"{{baseUrl}}/v1/freeze/health","host":["{{baseUrl}}"],"path":["v1","freeze","health"]}}}]}]}