{"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":"Venue Data API","description":"Measured stablecoin flows for the African exchanges, payment companies and on- and off-ramps AfriFlux tracks: deposits, wallets, market share, outflow and net flow per day, week, month or quarter, plus the latest-quarter league table. The same figures as the AfriFlux venue pages, with every caveat attached to the number it applies to.","item":[{"name":"One venue's flow history","request":{"method":"GET","description":"Inflow, wallets, market share and change for one venue, per day (last 90), week (52), month (24) or quarter (since tracking began), with outflow and net flow where AfriFlux measures them. Retail venues report customer deposits only; a business book, where the venue has one, is in the league table's business list and never inside these figures. Outflow is omitted, with a reason, where it isn't measured or is too small to publish. VALR and Luno leave out addresses of $1M or more, and excluded_large_flows gives that lifetime total. Every period carries complete; the current period is never complete. Get slugs from GET /v1/reference/venues.","header":[],"url":{"raw":"{{baseUrl}}/v1/venues/:slug/flows?grain=weekly&from=2026-11-09","host":["{{baseUrl}}"],"path":["v1","venues",":slug","flows"],"query":[{"key":"grain","value":"weekly"},{"key":"from","value":"2026-11-09"},{"key":"to","value":"","disabled":true}],"variable":[{"key":"slug","value":"quidax"}]}}},{"name":"Venue league table","request":{"method":"GET","description":"Every venue's latest complete quarter: volume, change on the quarter before, market share, wallets and rank, in two lists that never mix. The retail list ranks customer deposits; total_flow_usd and business_usd, where present, show what the venue moved beyond retail and must not be added to volume. The business list ranks business-only venues and the business half of venues whose books separate. Filter by category or country (ISO code); ranks stay market-wide. Paid accounts also get each venue's standing within its category.","header":[],"url":{"raw":"{{baseUrl}}/v1/venues/leaderboard?country=ZA","host":["{{baseUrl}}"],"path":["v1","venues","leaderboard"],"query":[{"key":"category","value":"","disabled":true},{"key":"country","value":"ZA"}]}}},{"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/venues/health","host":["{{baseUrl}}"],"path":["v1","venues","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":"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":"Check an EVM or Tron address against the OFAC, UK and EU sanctions lists and against stablecoin issuers' freeze lists. You see which list names it and who it belongs to, whether an issuer froze it or it is one step from frozen money at the African venues AfriFlux tracks, and whether a venue paid it after the freeze. You pay only when we have a record. No record means no list we check names the address and we hold no freeze record on it, 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    \"0x00000000000000000000000000000000000f0003\",\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"]}}}]},{"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, whether the OFAC, UK or EU sanctions lists name it, 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"]}}}]}]}