Rails

Filecoin Pay rails.

Shape

Table
rails
Rows ≈
3,059 · 40 columns · local snapshot
Grain
Key not declared
Observed, UTC
Not date-indexed · view built 2026-11-17
Raw sources
raw.filecoin_api_rails, raw.riba_eth_logs, raw.riba_eth_logs_decoded · raw assets

Query

DuckDB, reads the published file
select *
from 'https://data.filecoindataportal.xyz/rails.parquet'
limit 10;

The published file is rebuilt daily; counts and sample here come from the local snapshot built 2026-11-17.

Columns

rails column definitions
NameTypeDescription
rail_idBIGINTFilecoin Pay rail identifier.
payerVARCHARPayer address.
payeeVARCHARPayee address.
tokenVARCHARERC20 token address.
token_symbolVARCHARERC20 token symbol.
token_decimalsINTEGERERC20 token decimals.
is_stablecoinBOOLEANWhether the rail token is a tagged stablecoin.
operatorVARCHAROperator address.
serviceVARCHARService classification.
validatorVARCHARValidator address.
service_fee_recipientVARCHARService fee recipient address.
commission_rate_bpsBIGINTCommission rate in basis points.
is_arr_eligibleBOOLEANWhether the rail counts toward recurring run-rate (tagged stablecoin, non-Dealbot payer).
created_blockBIGINTCreation block number.
created_log_indexBIGINTCreation log index.
created_transaction_hashVARCHARCreation transaction hash.
created_atTIMESTAMP WITH TIME ZONEUTC creation timestamp.
terminated_blockBIGINTTermination block number, if any.
terminated_log_indexBIGINTTermination log index, if any.
terminated_transaction_hashVARCHARTermination transaction hash, if any.
terminated_byVARCHARAddress that terminated the rail, if any.
terminated_end_epochBIGINTEnd epoch emitted on termination, if any.
terminated_atTIMESTAMP WITH TIME ZONEUTC termination timestamp, if any.
terminated_end_atTIMESTAMP WITH TIME ZONEUTC termination end timestamp, if any.
is_terminatedBOOLEANWhether the rail has a termination event.
data_set_idBIGINTWarm Storage data set paid by the rail, if any.
stateVARCHARCurrent lifecycle state (active, terminated, finalized), from the Filecoin API.
payment_rateDECIMAL(38,0)Current payment rate in token base units per epoch, from the Filecoin API.
lockup_periodBIGINTCurrent lockup period in epochs, from the Filecoin API.
lockup_fixedDECIMAL(38,0)Current fixed lockup in token base units, from the Filecoin API.
settled_up_toBIGINTEpoch settled up to, from the Filecoin API.
total_settled_amountDECIMAL(38,0)Cumulative settled amount in token base units, from the Filecoin API.
total_net_payee_amountDECIMAL(38,0)Cumulative settled amount net to payee in token base units, from the Filecoin API.
total_one_time_amountDECIMAL(38,0)Cumulative one-time payments in token base units, from the Filecoin API.
total_one_time_net_payee_amountDECIMAL(38,0)Cumulative one-time payments net to payee in token base units, from the Filecoin API.
api_indexed_blockBIGINTLatest API indexer block before the snapshot.
api_observed_atTIMESTAMPUTC Filecoin API snapshot timestamp.
rate_historySTRUCT(date DATE, rate DECIMAL(38,0))[]Sparse end-of-day rates in token base units per epoch, ordered by date.
history_startDATEFirst UTC date in FEVM checkpoint coverage.
history_endDATELast UTC date in FEVM checkpoint coverage.

Sample

5 rows from the local snapshot, exactly as stored.

rails sample rows
rail_idpayerpayeetokentoken_symboltoken_decimalsis_stablecoinoperatorservicevalidatorservice_fee_recipientcommission_rate_bpsis_arr_eligiblecreated_blockcreated_log_indexcreated_transaction_hashcreated_atterminated_blockterminated_log_indexterminated_transaction_hashterminated_byterminated_end_epochterminated_atterminated_end_atis_terminateddata_set_idstatepayment_ratelockup_periodlockup_fixedsettled_up_tototal_settled_amounttotal_net_payee_amounttotal_one_time_amounttotal_one_time_net_payee_amountapi_indexed_blockapi_observed_atrate_historyhistory_starthistory_end
30590x305025d07c1dee47f25a4990179eff2becddca0b0x73684a70ffab6c6aec474ec0c13b376607ec4af40x80b98d3aa09ffff255c3ba4a241111ff1262f045USDFC18true0x8408502033c418e1bbc97ce9ac48e5528f371a9fFWSS0x8408502033c418e1bbc97ce9ac48e5528f371a9f0x8408502033c418e1bbc97ce9ac48e5528f371a9f0false655215450xb4ab61ca767737cdc63018770b73903c674496d6adfdc7b54531c60f0a2648ed2026-11-16 23:17:00+00nullnullnullnullnullnullnullfalse1949active138999817762786400420000000000000000655215400800000000000000007960000000000000065549372026-11-17 22:29:36.211178[{"date":"2026-11-16","rate":"1388894281486"}]2025-08-012026-11-16
30580x305025d07c1dee47f25a4990179eff2becddca0b0x73684a70ffab6c6aec474ec0c13b376607ec4af40x80b98d3aa09ffff255c3ba4a241111ff1262f045USDFC18true0x8408502033c418e1bbc97ce9ac48e5528f371a9fFWSS0x8408502033c418e1bbc97ce9ac48e5528f371a9f0x8408502033c418e1bbc97ce9ac48e5528f371a9f0false655167300xdebba219f23eeadbb730bc4cb30e7bc6d862e834d34e30a3dd77c72728fbc4322026-11-16 19:16:30+00nullnullnullnullnullnullnullfalse1948active139027415166386400409000000000000000655167300910000000000000009054500000000000065549372026-11-17 22:29:36.211178[{"date":"2026-11-16","rate":"1388894281486"}]2025-08-012026-11-16
30570x261465ebfc3e3e84c36da8985912ade2a052756e0xc38658920c2f47b5a6d311640210e14c8d2b8c880x80b98d3aa09ffff255c3ba4a241111ff1262f045USDFC18true0x8408502033c418e1bbc97ce9ac48e5528f371a9fFWSS0x8408502033c418e1bbc97ce9ac48e5528f371a9f0x8408502033c418e1bbc97ce9ac48e5528f371a9f0true6551484390x60687c607638eca81e7e2b428882581777a97b77cd6e0fa87cda3851c34c1ea22026-11-16 17:42:00+00nullnullnullnullnullnullnullfalse1947active138888909441986400453000000000000000655148400470000000000000004676500000000000065549372026-11-17 22:29:36.211178[{"date":"2026-11-16","rate":"1388889094419"}]2025-08-012026-11-16
30560x5f4ccc7001a98375e46d2b5ac5024832cb5256220xe597df49cf802765488f9004a764d5fdaad5dd100x80b98d3aa09ffff255c3ba4a241111ff1262f045USDFC18true0x8408502033c418e1bbc97ce9ac48e5528f371a9fFWSS0x8408502033c418e1bbc97ce9ac48e5528f371a9f0x8408502033c418e1bbc97ce9ac48e5528f371a9f0true6551257430x9f5a97f7f8154ecff01169f6ab94b30959f8679e099cbef3fcb86f6ba8702b5d2026-11-16 15:48:30+00nullnullnullnullnullnullnullfalse1946active141739734295486400443000000000000000655125700570000000000000005671500000000000065549372026-11-17 22:29:36.211178[{"date":"2026-11-16","rate":"1417397342954"}]2025-08-012026-11-16
30550x305025d07c1dee47f25a4990179eff2becddca0b0x73684a70ffab6c6aec474ec0c13b376607ec4af40x80b98d3aa09ffff255c3ba4a241111ff1262f045USDFC18true0x8408502033c418e1bbc97ce9ac48e5528f371a9fFWSS0x8408502033c418e1bbc97ce9ac48e5528f371a9f0x8408502033c418e1bbc97ce9ac48e5528f371a9f0false6551194710x367b0eb4f773f837e3d2107c13a75a559b77dc12c6142ae756e745ec33b84b372026-11-16 15:17:00+00nullnullnullnullnullnullnullfalse1945active13905501256988640039800000000000000065511940010200000000000000010149000000000000065549372026-11-17 22:29:36.211178[{"date":"2026-11-16","rate":"1389170255521"}]2025-08-012026-11-16